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Important Information 


UPS Developer Kit APIs 


Your developmentofan application using UPS Developer Kit APIs is governed by the UPS Technology 
Agreement you entered into with UPS. The following are key legal requirements from these agreements for the 
UPS Developer Kit APIs. For more information on all requirements for the UPS Developer Kit APIs, please refer 
to the UPS Technology Agreement. 


Defined terms used but not defined in this documenthave the meaning set forth in the UPS Technology 
Agreement. 


Key Legal Requirements for UPS Developer APIs 


Permitted Territories 


This documentcan only beused in the countries of the Permitted Territory as defined in the UPS Technology 
Agreement, as applicable. 


Use 


The application must not be designed to allow distribution of information received through the UPS Developer 
Kit APIs to third parties, other than to persons having a bona fide interestin such information (e.g., the shipper, 
receiver, or the third party payer, or to your service providers authorized by UPS). 


Consent to Use of UPS Mark 


e All screens or forms generated by your applicationincluding information received through the UPS Developer Kit 
APls must include (1) the UPS Mark positioned in reasonable proximity to the Information and of an appropriate 
size to readily identify the source of the Information as UPS and (2) the following language at the bottom of 
every screen thatdisplays the UPS Mark: "UPS, the UPS brand mark, and the Color Brown are trademarks of 
United Parcel Service of America, Inc. All Rights Reserved." Exceptas set forth in the preceding sentence, you 
have no rightto use the UPS Mark withoutthe prior written approval of UPS. 


e You shall notuse the UPS Mark in association with any third party trademarks in amanner that mightsuggest 
co-branding or otherwise create potential confusion as to source or sponsorship of the application, or ownership 
of the UPS Mark. 


e The UPS Mark shall be used only as providedby UPS electronically or in hard copy form. The UPS Mark may 
notbe altered in any manner, including proportions, colors, elements, etc., or animated, morphed or otherwise 
distorted in perspective or dimensional appearance. 


e The UPS Mark may notbe combined with any other symbols, including words, logos, icons, graphics, photos, 
slogans, numbers, or other design elements. A minimum amount of empty space must surround the UPS Mark 
separating itfrom any other object, such as type, photography, borders, edges, etc. The required area of empty 
space around the UPS Mark must be 1/3x, where x equals the heightofthe UPS Mark. 


Copyright and Proprietary Notice 


In your application and any POD Letters you prepare, youmust include aprominentreproduction of UPS’s 
copyright and proprietary notices in aform and format specified by UPS (See the Copyright section ofthis 
document). 


Display of Information 


The application must notdisplay information concerning any other provider of shipping services or such other 
shipping services on any page, whether comprising one or more frames, displaying information your application 
receives from the UPS Developer Kit APIs. Your application must present all data within each field received 
through the UPS Developer Kit APIs without amendment, deletion, or modification of any type. 
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Notice 


In allcommunications with UPS concerning thisdocument, please refer to the document date located on the 
cover. 


Copyright 
© 2021 United Parcel Service of America, Inc. All Rights Reserved. Confidential and Proprietary 


The use, disclosure, reproduction, modification, transfer, or transmittal of this work for any purposein any form 
or by any means without the written permission of United Parcel Service is strictly prohibited. 


Trademarks 


Some ofthe UPS corporate applications use United States city, state, and postal code info rmation obtained by 
United Parcel Service of America, Inc. under a non-exclusive license from the United States Postal Service. 


Disclaimer 


UPS Freight Less-than-Truckload (“LTL”) transportation services are offered by TFI International Inc., its 
affiliates or divisions (including without limitation TForce Freight), which are not affiliated with United Parcel 
Service, Inc. or any of its affiliates, subsidiaries or related entities (“UPS”). UPS assumes no liability in 
connection with UPS FreightLTL transportation services or any other services offered or provided by TFI 
International Inc. or its affiliates, divisions, subsidiaries or related entities. 
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Chapter 1: Introduction 


In this document, youwill find guidance and instructions for integrating the Tracking Web Service into your 
application, service, or system. 

In this guide, you will find: 

e New release features 

e Tracking Web Service API functionality and business rules 

e Web service API request and response schema 

e FAQs forthe Tracking API 

e Tracking error response codedescriptions 


e Service codereferences 


This guide applies to the following API: 
e SOAP API forthe Tracking Web Service 


This guide does not apply to the following APIs: 
e Tracking XML API 
e Any API for Ground Freight or Air Freight 


Intended Audience 


This guideis intended for developers who willbe integrating the Tracking Web Service API into their application, 
service, or system. 


Required Knowledge & Skills 

This guide assumes you have a basic understanding of the following: 

e Concepts and instructions in the Introduction to the UPS Developer Kit guide 
e XML syntax and structure 

e Web services 


e Software development 


How to Use this Guide 


e If this is your first time working with the UPS Developer Kit, begin with the Introduction to the UPS Developer Kit 
guide. This guide serves as the foundation for all APl-specific developer guides. 


e lf you are experienced with the UPS Developer Kit but have not yet worked with the Tracking API, continue with 
Chapter 2: Understanding the Tracking API. There youwill find an overview of the Tracking functionality and 
business rules. 


e Chapter 3: Customer Integration Environment (CIE) contains information on UPSintegration environments. 


e Chapter 4: Tracking API Elements and Details contains an overview ofthe top-level containers and elements that 
comprise the Tracking request and response. 


e Request and response examples are located in Chapter 5: Tracking Web Service Examples. 


e Reference tables, services codes, and error codes are located in the Appendices. 
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Release Features 
October 2020 


UPS Premier 


UPS® Premier is a contract service that will provide additional visibility to critical healthcare -specific movements for 
the following services: 


e UPS® Premier Silver 
e UPS® Premier Gold 
e UPS® Premier Platinum 


Tracking will now include the premier accessorial, code and description in the tracking response when requested. 
New subversion 2009 has been added for UPS Premier. 


January 2020 


No changes 
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Chapter 2: Understanding the Tracking API 


Business Rules 


General 


e UPS expects schema elements/tags as defined in the XPath and presented in the schema structure without 
spelling or structural deviations. Elements/tags that are not defined in the schema or do notconformto the schema 
structure will be ignored by UPS. 


e Only users that plan to ship packages manifested, tendered, and delivered by UPS can use the API. 
e Any customers/developers abusing or data mining the API will have their access revoked. 
e Toaccess API documentation the user must haveor create a UPS profile. 


e To access testing and production sites the user must have an Access Key. To get an Access Key you must havea 
UPS profile and an associated shipping account. For additionalinformatio n, refer to the UPS Developer kit User 
Guide. 


Tracking 
e The Tracking API supports Package, Ground Freightand Air Freight shipments. 


e UPS Freight must bill the shipmentbefore information is passed to UPS.comor QVM. UPS has a rule that header 
information mustbe established before the shipmentcan be displayed. Header information is established at the 
billing point; this usually occurs the night ofthe shipment. 


e Some Tracking datamay notbe returned in the response because the data rolled off. Database retention times: 
o Manifest information, and Manifest Voided scans: 120 days 
o Exceptions scans: 120days 
o In Transit scans like Origin/Arrivals/Departures/Destination scans: 120 days 
o Delivery records and signature images: 120 days 


e Trade Direct small package manifest uploads arekeptin an advanced PLD database, and only released for 
visibility after the Origin scan is applied to the label. 


UPS Signature Tracking® 


The Signature Tracking API gives client applications access to UPS Signature Tracking information. If UPS has 
successfully delivered ashipmentor package to its destination, tracking requests may return signature information for 
the delivery. The response can include the name of the person who signed for the delivery, an image of that person's 
signature, ora full proofofdelivery letter. For moreinformation onproof of delivery letters, please consultthe 
appendix. 


Tracking Usage Guidelines 


The following guidelines are included so all UPS customers can use UPS Tracking without delays: 


e Ensure tracking requests are valid. If your request returns an error message such as "tracking number not found", 
"no information available", or "invalid tracking number", you should research the cause ofthe error before 
continuing to track the same number. 


e When theresults ofa tracking request indicate a “delivered” status, do not continue to track the package. 
e Track packages during “offhours’ whenever possible. Off hours are from 5:00 pm to 8:00 am East Coasttime. 


e Use your UPS service level (Early, Next Day Air, etc.) to determine the best time ofday to track and receive up to 
the minute tracking information. 


e Evenly distribute your information requests over the remaining 19-hour window. 
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e Refrain from tracking the same numbers continually throughout the day. Unique tracking numbers should be 
tracked no morethan once per hour or a maximum of 24 times in a singleday. 


e Avoid automatic access between 10:00 am to 3:00 pmEST. However, youmay track critical packages during this 
time. 


Me 


If daily/weekly tracking requests exceed daily shipping volume by a large margin, UPS reserves the rightto 
suspend tracking for that account until the situation is rectified. Ifa resolution cannot be found and implemented, 
tracking for that account may be terminated. 


Identifying a Package or Shipment 


Applications can request tracking based on atracking number, shipmentidentification number, or reference number. 
For freight shipments, applications can also use a candidate bookmark. 


Tracking Numbers 


UPS uses tracking numbers to identify and track packages in its system. Applications can use this tracking number to 
track, locate, and verify arrival ofa package. A successful query by tracking number returns information for the 
specific package withina shipment. For example, ifa package shipment contained four individual packages, the 
query response would show ashipmentcontaining the one package out of four with the associated tracking number. 


= NOTE: Tracking numbers are available up to 120 days after delivery. UPS makes every effort to ensure that a 
tracking number uniquely identifies apackage for 120 days. However, it is possible that a tracking number may 
be reused within ashorter time period. If this occurs ,aquery by tracking number returns all packages matching 
the tracking number. 


Shipment Identification Numbers 


UPS uses shipmentidentification numbers to identify and track every shipmentas it moves through the UPS system. 
A shipment may be a single transaction with multiple packages, or it may be a single freight shipment. 


For package shipments, a successful query by shipment identification number returns all of the packages withina 
shipment. For example, ifa shipment contained four packages, the query response would showall four packages. 


Me 


NOTE: UPS makes every effortto ensure that a shipment identification number uniquely identifies ashipment for 
up to 120 days. However, itis possible thata shipment identification number may be reused within ashorter time 
period. If this occurs, aquery by shipmentidentification number returns all shipments matching the shipment 
identification number. 


PRO numbers and Air Waybill numbers 


UPS uses PRO numbers to identify and trace a Ground Freight shipment as it moves through the UPS system. For 
freightshipments, asuccessful query by PRO number returns all ofthe commodities withina shipment. 


UPS uses Air Waybill numbers to identify and trace an Air Freightshipmentas it moves through the UPS system. For 
freightshipments, asuccessful query by Air Waybill number returns all of the commodities within ashipment. 
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Candidate Bookmarks 


When an application requests tracking information for a freight shipmentusing areference number, it is possible that 
more than one shipment may match that reference number. In such cases, UPS returns identifying information about 
each shipment, and itmarks each shipment with a unique candidate bookmark. 


Clientap plications (or their users) can examine the list of candidates to identify the desired shipment. Once the 
candidate is identified, the application can issue another tracking request. By including the candidate bookmark 
information for the appropriate shipmentin this second request, the application eliminates ambiguity and can receive 
correcttracking results. 


Reference Numbers 


The ability to track any UPS package or shipmentby reference number gives applications added flexibility and 
convenience. Reference numbers can be a purchase order number, job number, or a group of words identifying a 
shipment(such as “10 widgets” or “giftfor mom’). 


e Applications can assign areference number to an individual package or to all packages in ashipment. 
e Areference number can contain any combination of letters and numbers up to 35 characters. 
e Applications assign areference number when they upload electronic shipping datato UPS. 


e A successful query by reference number returns all of the packages within ashipmentidentified by the reference 
number. For example, if a shipment contained four packages, and two of the packages were tagged with the 
reference number, “10 widgets,” the query response would showa shipment containing those two packages. 


Since reference numbers are assigned by customers, UPS cannot guarantee the uniqueness ofa reference number 
across all packages shipped through the UPS system. To resolve this ambiguity, a search specification may contain 
any of the following qualifiers: 


e Pickup date range: A range of dates within which UPS picked up the package. The default is 30 days before 
today's date. 


e UPS accountnumber: The shipper's UPS account number. 
e Destination postal code: Azip code(U.S.) or postal code (international). 


e Destination country or territory: The destination country or territory code. 


= NOTE: Reference numbers are available up to 6 months after the shipper provided the electronic manifest, and 
may roll off before the delivery record. 
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Chapter 3: Customer Integration Environment (CIE) 


The Customer Integration Environmentallows customers to testtheir application prior to launch. This environmentis 
intended for integration testing of customer applications with the UPS servers. 


Once your application has been thoroughly tested, you should redirect the application to the UPS Production 
Environment. 


No stress testing should ever be performed by customers against any UPS systems. 


To access testing and production sites the user must havean Access Key. You can request an Access Key after 
establishing aUPS profile and associating your shipping account. 


System Availability 


The Customer Integration Environmentis available 24 hours a day, 7 days a week. Note, the system is occasionally 
down for server maintenance. 


All API URLs are case sensitive. 


Integration Testing 


For integration testing, direct your Tracking Web Service to: htips://wwwcie.ups.com/webservices/T rack 


Production 


Once testing is complete, direct your Tracking Web Service API to the production URL: 


https://onlinetools.ups.com/webservices/Track 


Server Availability Check 


All ofthe UPS services work using HTTPS POST. If the server is available, it will reply with the service name, remote 
user, server port, server name, and servlet path. 


To see this in action, type the following URLin your web browser: hitps://wwwcie.ups.com/webservices/Track 


Server Name: Track 

Remote User: Null 

Server Port: 443 

Server Name: wwwcie.ups.com 
Servlet Path: /Track 
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Shipping and Tracking Numbers for Testing 
The following tables contain shipping and tracking numbers for use in the testing environment and describes the 
results that developers should expect when attempting a TrackRequest. 


When using tracking numbers other than those designated for testing in CIE, the numbers will be evaluated as 
production tracking numbers. 


NOTE: For Web Service only. Signature image details in CIE are returned for only the tracking numbers below. 


Tracking 1Z12345E0205271688 Activity (All) 2nd Day Air Delivered 
(Signature Availability) 


Tracking 1Z12345E6605272234 None (Last) World Wide Delivered 
Express 
Shipping 1Z12345E0305271640 None (Last) Ground Delivered 
(Second Package: 
1Z12345E0393657226) 
Tracking 1Z12345E1305277940 None (Last) Next Day Air ORIGIN SCAN 
Saver 
Tracking 1Z12345E6205277936 Activity (All) Next Day Air 2nd Delivery attempt 
Saver 
Tracking 1Z12345E020527079 None (Last) Invalid Tracking Number 
Tracking 1Z12345E1505270452 None (Last) No Tracking Information 
Available 
Tracking 990728071 Activity (All) UPS FreightLTL In Transit 
Tracking 3251026119 Activity (All) Delivered Origin CFS 
MI Tracking 9102084383041101186729 = None (Last) 
Number 
MI Reference | cgish000116630 None (Last) 
Number 
Tracking 1Z648616E192760718 Activity UPS Worldwide —=§ Order Process by UPS 
Express Freight 
Tracking 5548789114 Activity UPS Express Response for UPS Air 
Freight Freight 
Tracking ER751 105042015062 Activity UPS Ocean Response for UPS Ocean 
Freight 
Tracking 1ZW X0692YP40636269 Activity UPS SUREPOST _— Response for UPS 
SUREPOST 
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Chapter 4: Tracking API Elements and Details 


Element Constraints 


The Request and Response XPath tables contain the full hierarchy of the API elements. 


Hy) 


UPS expects schema elements/tags as defined in the XPath and presented in the schema structure i.e., no 
spelling or structural deviations. Elements/tags that are not defined in the schema or do notconformto the 
schema structure will be ignored by UPS. 


Element constraints are defined as follows: 


Required 

e Yes - indicates the element must be presentin the request or response. 

e Yes* - indicates the element must be present in the request if the parent container is presentin the request. 
e No -indicates the element is optional and may be used if it applies to the request. 


e Cond -—indicates the element is required under certain conditions. 


Type 
e Container - holds agroup ofrelated elements. 


e String - consists of alphanumeric characters, spaces, and decimals. 


Length 


e The maximum number of characters that can be presentin a String. Length is not applicable (N/A) to Containers. 


Max Allowed 


e The maximum number of elements or containers that can be presentin the parent container. 
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TrackRequest XPath 

[Name ___|Constraint___|Description | Validation 
/TrackRequest 
TrackRequest Required: Yes Container for the root Track All 


Type: Container | Request. Package, Mail 

Max Allowed:1 | Innovations and freight 

Length: N/A shipmentcan be tracked by 
invoking this request. 


Users have three ways to 
track, by inquiry number, by 
reference number, or by 
candidate bookmark. 
Candidate bookmark applies 
to Freight tracking only. 


Request 


/TrackRequest/Request 


Request Required: Yes Common Request element All 
Type: Container | should be provided by users 
Max Allowed: 1 
Length: N/A 

/TrackRequest/Request/RequestOption 

RequestOption Required:Cond | For optional processing. For valid values, see All 
Type: String Request Option Codes in the 
Max Allowed: 1 Appendix. 
Length: 1..15 

/TrackRequest/Request/SubVersion 

SubVersion Required: Yes* When UPS introduces new — Supported values: 0114, All 
Type: String elements in the response 1407, 1507, 
Max Allowed:1 that are notassociated with §1801,1907,1909,2009 
Length: 4 new request elements, 


Subversion is used. This 
ensures backward 
compatibility. 


To get such elements you 
need to have the right 
Subversion. The value of the 
subversion is explained in 
the Response element 
Description. 


Example: Itemized Charges 
are returned only when the 
Subversion element is 
present and greater than or 
equal to '1601'. 


Format: YYMM = Year and 
month ofthe release. 
Example: 1601 = 2016 
January 


/TrackRequest/Request/TransactionReference 


TransactionReferenc| Required: Yes* | TransactionReference All 
e Type: Container | identifies transactions 
between clientand server. 
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Max Allowed: 1 
Length: N/A 

/TrackRequest/Request/TransactionReference/Custo merContext 

CustomerContext Required: Yes* | Theclientuses All 
Type: String CustomerContext to 


Max Allowed:1 | synchronize 

Length: 1..512 request/response pairs. The 
clientestablishes 
CustomerContext, which can 
contain any information you 
want, as long asitis valid 
XML, it is echoed back by 
the server. 
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/TrackRequest/Inquiry Number 


Required: Cond 
Type: String 
Max Allowed: 1 
Length: 9..34 


Inquiry Number 


Inquiry Number. 


Package: 

For package, the number will 
be treated as Shipment 
Identification Number or 
Package Tracking Number 
based on the value of the 
element Tracking Option. 


Tracking options: 

01, the inquiry number will be 
treated as shipment 
identification number. 

02, the inquiry number will be 
treated as package Tracking 
number. 


Freight: 

For freight, the number will 
be always treated as the 
tracking number of the 
shipmentregardless ofthe 
value of the Tracking Option. 


Mail Innovations: 

For mail innovations this 
number will be the tracking 
number. When tracking for 
mail innovations by tracking 
number the TrackingOption 
also needs to be set to03. 


For mail innovations different 
types of tracking numbers 
apply like - Sequence 
number (Mail Manifest ID / 
MMS), Postal service 
Tracking ID. 


/TrackRequest/IncludeMailln novationIndicator 


IncludeMaillnnovatio Required: No 

nindicator Type: String 
Max Allowed: 1 
Length: 0 
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TrackingOption 


/TrackRequest/TrackingOption 


Tracking Option Required:Cond | Tracking Option applies to Package and Mail PKG, MI 
Type: String Package and Mail Innovations only. 
Max Allowed:1 — Innovations only. 
Length: 2 
Package: 


01 - Single trackable entity 
with more trackable entities 
inside it 

02 - Single trackable entity 
with no more trackable 
entities insideit 


If value or element is not 
found, then Inquiry number 
will be treated as Shipment 
Identification Number. 


If the TrackingOption is not 
present then it will return all 
packages informationifitisa 
Multi-package shipment 
(Which means Tracking 
number willbe treated as 
Shipment ldentification 
number). 

Freight: 


Freight: 

For Freight, This element will 
be ignored and the Inquiry 
number will always be 
treated as Shipment 
Identification Number. 


For Freight Inquiry Number 
this field will not be used so 
all the information about that 
freight shipmentwill be 
returned. 


Mail Innovations: 

For Mail Innovations track by 
number, this is a mandatory 
field which has to be set to 
03. 

For Mail Innovationsasingle 
shipmenthas single 
package. 
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CandidateBookmark 


/TrackRequest/CandidateBookmark 


CandidateBookmark | Required: No During InquiryNumber and FRT 

Type: String Reference Number 

Max Allowed:1 | searches, it is possible that 

Length: 1..15 duplicate shipments willbe 
found. If duplicate shipments 
are found, then a Candidate 
Summary witha 
corresponding 
CandidateBookmark for each 
of the Shipments will be 
returned in the track 
response. 


This Base64 encoded 
CandidateBookmark can be 
passed back to the Tracking 
servicein a separate request 
to retrieve tracking 
information about the 
particular shipmentof 
interest. It does notapply to 
package tracking or Mail 
Innovations. 


/TrackRequest/ReferenceNumber 


ReferenceNumber Required:Cond | The reference number PKG, MI 
Type: Container | container. Required if an 
Max Allowed:1 — inquiry number or candidate 
Length: N/A bookmark is not present. 
The reference number for 
Mail Innovations needs to be 
set here along with 
appropriate codein 
ShipmentType. 


/TrackRequest/ReferenceNumber/Value 


Value Required: Yes* | The customer assigned PKG, MI 
Type: String reference number. 
Max Allowed: 1 
Length: 1..35 

/TrackRequest/Pickup DateRange 

PickupDateRange Required: Yes* The additional information of All 


Type: Container | pickup date range to support 
Max Allowed:1 | and narrowa reference 
Length: N/A number search. 
For Mail Innovationsthis is 
optional field for tracking by 
reference number. 


/TrackRequest/Pickup DateRange/BeginDate 


BeginDate Required: Yes* | The beginning pickup date All 
Type: String used to narrowa reference 
Max Allowed:1 | number search. 
Length:8 Format: YYYYMMDD. 

/TrackRequest/Pickup DateRange/EndDate 

EndDate Required: Yes* | The end pickup date used to All 
Type: String narrowa reference number 
Max Allowed:1 — search. 
Length: 8 Format: YYYYMMDD. MM 


ranges from01 to 12. 
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/TrackRequest/ShipperNumber 


ShipperNumber Required: Yes* | The UPS accountnumber PKG, FRT 
Type: String used to narrowa reference 
Max Allowed:1 | number search. 
Length: 6 or10 


/TrackRequest/Ship From 


ShipFrom Required: Yes* | Container for ship from FRT 
Type: Container | address used to narrowa 
Max Allowed:1 reference number search. 


Length: N/A 
/TrackRequest/Ship From/Address 
Address Required: Yes* Container forthe origin FRT 


Type: Container | country/territory code and 
Max Allowed:1 | origin postal code used to 


Length: N/A narrow a reference number 
search. 
/TrackRequest/Ship From/Address/Po stalCode 
PostalCode Required: Yes* Postal Code of the origin FRT 
Type: String country/territory. 
Max Allowed: 1 
Length: 1..16 
/TrackRequest/Ship From/Address/Country Code 
CountryCode Required: Yes* | Country or Territory Code of FRT 
Type: String the origincountry or territory. 
Max Allowed: 1 
Length:2 
/TrackRequest/Ship To 
ShipTo Required: Yes* | Container for the Destination All 


Type: Container | Address to narrow the 
Max Allowed:1 | reference number search. 


Length: N/A 
/TrackRequest/Ship To/Address 
Address Required: Yes* | Container for the destination All 


Type: Container | postal code and destination 
Max Allowed:1 | country/territory Code. 


Length: N/A 
/TrackRequest/Ship To/Address/PostalCode 
PostalCode Required: Yes* | Postal code of postal All 
Type: String destination country/territory. 
Max Allowed: 1 
Length: 1..16 
/TrackRequest/Ship To/Address/Country Code 
CountryCode Required: Yes* | Destination country or All 
Type: String territory code 
Max Allowed: 1 
Length:2 
/TrackRequest/ShipmentType 
ShipmentType Required: Cond. Container for the type of All 


Type: Container | Shipmentwhen doinga 

Max Allowed:1 | Reference Number search. 

Length: N/A This element is required if 
the Reference Number 
element is specified. 


/TrackRequest/ShipmentType/Code 
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Code Required: Yes* This element willbe used to _ Valid values: 

Type: String indicate the typeof the 01 = Package (Default) 

Max Allowed:1 | shipmentbeing tracked 02 = Freight 

Length:2 during Reference number 03 = Mail Innovations 

tracking. 

/TrackRequest/Preauth orized Return Indicator 
PreauthorizedReturn | Required: No Indicator to request Pre- This is an indicator. PKG, MI 
Indicator Type: String authorized For Return (PFR) | Valid value is: 

Max Allowed:1 _ eligibility information, URLto Y - PFR information is 

Length: 1 submit pre-authorized return required. 


request and other PFR 
related data. For small 
package and Mail Innovation 
packages. 
Valid value is: 
Y - PFR information is 
required. 
/TrackRequest/Locale 
Locale Required: No Locale will be used to Examples: en_US, fr_FR All 
Type: String providetranslated textin 
Max Allowed:1 | Activity Status Description 
Length:5 and Current Status 
Description. 
Default Value is: 
en_US 


ShipperAccountinfo 


/TrackRequest/ShipperAccountInfo 


ShipperAccountInfo | Required:Cond Container for Shippers Package Signature Tracking PKG SIG 
Type: Container | accountdetails. only. 
Max Allowed: 1 
Length: N/A Used to verify the customers 


signature tracking privileges 
for package tracking if 
shipper selects one ofthe 
RequestOption including 
signature track. 


/TrackRequest/ShipperAccountlnfo/PostalCode 


PostalCode Required: Yes* | Postal Codeofthe Shipper Package Signature Tracking PKG SIG 
Type: String Account used to place the only. 
Max Allowed:1 | shipment. 
Length: 1..9 


This data will be used in 
verifying the rights ofthe 
customer to view signature 
results. 


/TrackRequest/Ship perAccountInfo/CountryCode 


CountryCode Required: Yes* | Country or Territory Codeof Package Signature Tracking PKG SIG 
Type: String the Shipper Accountused to | only. 
Max Allowed:1 = placethe shipment. 
Length:2 


This data will be used in 
verifying the rights ofthe 
customer to view signature 
results. 
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TrackResponse XPath 
/TrackResponse 
TrackResponse Required: Yes Container for root Track All 
Type: Container | Response. 
Max Allowed: 1 
Length: N/A 
Response 


/TrackResponse/Response 


Response Required: Yes Container for common All 
Type: Container | Response element. 
Max Allowed: 1 
Length: N/A 

/TrackResponse/Response/Resp onseStatus 

ResponseStatus Required: Yes Response Status Container. All 
Type: Container 
Max Allowed: 1 
Length: N/A 

/TrackResponse/Response/ResponseStatus/Code 

Code Required: Yes Identifies the success or failure All 
Type: String of the transaction. 
Max Allowed: 1 1 = Successful 
Length: 1 

/TrackResponse/Response/ResponseStatus/Description 

Description Required: Yes Describes Response Status All 
Type: String Code. Returns text of Success. 
Max Allowed: 1 
Length: 1..35 

/TrackResponse/Response/Alert 

Alert Required:Cond. — Alert Container. Therecan be All 


Type:Container — zero to many alert containers 
Max Allowed: UNB_ with code and description. 
Length: N/A 


/TrackResponse/Response/Alert/Code 


Code Required: Yes* Warning code returned by the All 
Type: String system. 
Max Allowed: 1 
Length: 1..10 

/TrackResponse/Response/Alert/Description 

Description Required: Yes* Warning messages returned by All 
Type: String the system 
Max Allowed: 1 


Length: 1..150 
/TrackResponse/Response/Transaction Reference 


TransactionReference Required: No Transaction Reference All 
Type: Container = Container. 
Max Allowed: 1 
Length: N/A 

/TrackResponse/Response/Transaction Reference/CustomerContext 

CustomerContext Required: Yes* The CustomerContext All 
Type: String Information which will be 
Max Allowed: 1 echoed during response. 


Length: 1..512 
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Shipment 


/TrackResponse/Shipment 


Shipment Required: Yes 
Type: Container 
Max Allowed: UNB 
Length: 1..240 


/TrackResponse/Shipment/InquiryNumber 

InquiryNumber Required: Yes 
Type: Container 
Max Allowed: 1 
Length: N/A 


Shipment Container 


Shipment Inquiry Number 
Container 


/TrackResponse/Shipment/InquiryNumber/Code 


Code Required: Yes 
Type: String 
Max Allowed: 1 
Length: 2..6 


Code to indicate the type of 
Inquiry Number. 


Package: 

For package this element 
returns: 

01 -Shipmentldentification 
Number 


Mail Innovations: 
03- Mail Innovation tracking 
number 


Freight: 

HAWB - House Airway Bill 
HBL - House BillofLading 
PRO — PRO Number 
SUBPRO — Sub-PRO Number 
DO — Delivery Order 


/TrackResponse/Ship ment/InquiryNumber/Description 


Description Required: Yes* 
Type: String 
Max Allowed: 1 
Length: 1..35 


Description of the Inquiry 


Number as indicated by code as 


above. 


/TrackResponse/Shipment/InquiryNumber/Value 


Value Required: Yes* 
Type: String 
Max Allowed: 1 
Length: 1..34 

/TrackResponse/Shipment/ShipmentType 

ShipmentType Required: No 
Type: Container 
Max Allowed: 1 
Length: N/A 


The actual value ofthe Inquiry 
Number. 


Container for the typeof 
Shipment. 


/TrackResponse/Shipment/ShipmentType/Code 


Code Required: Yes* 
Type: String 
Max Allowed: 1 
Length:2 


This element will be used to 
indicate the type of the 
shipmentbeing tracked, either 
Package, Mail Innovationsor 
Freight. 

01 - Package 

02 - Freight 

03 - Mail Innovations 


/TrackResponse/Shipment/ShipmentType/Description 


Description Required: Yes* 
Type: String 
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Max Allowed: 1 
Length: 1..15 


/TrackResponse/Shipment/CandidateBookmark 


CandidateBookmark Required: Cond 
Type: String 
Max Allowed: 1 
Length: 1..15 


/TrackResponse/Shipment/ShipperNumber 


Shipp erNumber Required: No 
Type: String 
Max Allowed: 1 
Length:6 or 10 


During Tracking and Reference 
Number searches, it is possible 
that duplicate shipmentswill be 
found. 


If duplicate shipments are 
found, then a Candidate 
Summary with a corresponding 
Base64 encodedCandidate 
Bookmark for each of the 
Shipments will be returned in 
the response. 


The Candidate Bookmark can 
be passed back to the tracking 
web servicein a separate track 
transaction to retrieve tracking 
information about the particular 
shipmentofinterest. 


The shippers UPS account 
number that placed this 
shipment 


/TrackResponse/Shipment/ShipmentAddress 


ShipmentAddress Required: Yes 


Type: Container 


Max Allowed: UNB 


Length: N/A 


An array of addresses 
associated with this shipment. 


/TrackResponse/Shipment/ShipmentAddress/Type 


Type Required: Yes 
Type: Container 
Max Allowed: 1 
Length: N/A 


Type of address. 


/TrackResponse/Shipment/ShipmentAddress/T ype/Code 


Code Required: Yes 
Type: String 
Max Allowed: 1 
Length:2 


Code of address: 
01 = Shipper Address 
02 = ShipTo Address 


For Mail Innovations, shipper 
address may be optionally 
present. 


/TrackResponse/Shipment/ShipmentAddress/Type/Description 


Description Required: Yes* 
Type: String 
Max Allowed: 1 
Length: 1..50 


Description of the code above. 


/TrackResponse/Shipment/ShipmentAddress/Address 


Address Required: Yes 
Type: Container 
Max Allowed: 1 
Length: N/A 


Address detail. 


/TrackResponse/Shipment/ShipmentAddress/Address/AddressLine 


AddressLine Required: Yes* 
Type: String 
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returned. 
Address lines will not be 
returned for Mail Innovations. 


/TrackResponse/Shipment/ShipmentAddress/Address/City 


City Required: Yes* 
Type: String 
Max Allowed: 1 
Length: 1..30 


City name. This is optional for 
Mail Innovations. 


/TrackResponse/Shipment/ShipmentAddress/Address/StateProvinceCode 


StateProvinceCode Required: Yes* 
Type: String 
Max Allowed: 1 
Length: 2..5 


State or province code. This is optional for Mail 
Required for country/territory Innovations. 
code US orCA. 


/TrackResponse/Shipment/ShipmentAddress/Address/Po stalCode 


PostalCode Required: Yes* 
Type: String 
Max Allowed: 1 
Length: 5..16 


Postal codeof this address. 


/TrackResponse/Shipment/ShipmentAddress/Address/CountryCode 


CountryCode Required: Yes* 
Type: String 
Max Allowed: 1 
Length:2 


/TrackResponse/Shipment/ShipmentWeight 


ShipmentWeight Required: No 
Type: Container 
Max Allowed: 1 
Length: N/A 


Country or Territory code. 


Shipment weightcontainer. 


/TrackResponse/Shipment/ShipmentWeight/Un itOfMeasurement 


UnitOfMeasurement Required: Yes* 
Type: Container 
Max Allowed: 1 
Length: N/A 


Shipment weightunitof 
measurement container. 


/TrackResponse/Shipment/ShipmentWeight/UnitOfMeasurement/Code 


Code Required: Yes* 
Type: String 
Max Allowed: 1 
Length:3 


Shipment weightunitof Values: 
measurement code. OZS 
LBS (default) 
KGS 


/TrackResponse/Shipment/ShipmentWeight/W eight 


Weight Required: Yes* 
Type: String 
Max Allowed: 1 
Length:8 


/TrackResponse/Shipment/Service 


Service Required: No 
Type: Container 
Max Allowed: 1 
Length: N/A 

/TrackResponse/Shipment/Service/Code 

Code Required: Yes* 
Type: String 
Max Allowed: 1 
Length: 2..4 


Shipment’s total weight. Set to 0 
for shipmentwith packagetype 
of letter. 


Container for UPS service 
associated with the shipment 


Service Code. For valid values, 
see Service Codes in the 
Appendix. 


/TrackResponse/Shipment/Service/Description 


Description Required: Yes* 
Type: String 


Description of the service. 
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Max Allowed: 1 

Length: 1..35 
/TrackResponse/Shipment/ReferenceNumber 
ReferenceNumber Required: No Shipment reference number 


Type: Container — container 
Max Allowed: UNB 


Length: N/A 
/TrackResponse/Shipment/ReferenceNumber/Code 
Code Required: Yes* Reference number type code for For valid values, see Reference 
Type: String signifying PO #s, Invoice#s. Number Codes in the Appendix. 
Max Allowed: 1 
Length: 2..3 
/TrackResponse/Shipment/ReferenceNumber/Description 
Description Required: Yes* Description of the code above. 
Type: String 
Max Allowed: 1 
Length: 1..35 
/TrackResponse/Shipment/ReferenceNumber/Value 
Value Required: Yes* The real value of the reference 
Type: String number supplied by a customer. 
Max Allowed: 1 
Length: 1..35 
/TrackResponse/Shipment/CurrentStatus 
CurrentStatus Required: No Container for the current status 
Type:Container — of the shipment. 
Max Allowed: 1 
Length: N/A 
/TrackResponse/Shipment/CurrentStatus/Code 
Code Required: Yes* Code for the current status of For valid values, see Current 
Type: String the shipment. Status Codes in the Appendix. 
Max Allowed: 1 
Length:3 
/TrackResponse/Shipment/CurrentStatus/Description 
Description Required: Yes* Description of the current status 
Type: String of the shipment. 
Max Allowed: 1 
Length: 1..35 
/TrackResponse/Shipment/PickupDate 
PickupDate Required: No Date the shipmentwas picked - 
Type: String up. Format: YYYYMMDD 
Max Allowed: 1 
Length:8 
/TrackResponse/Shipment/ServiceCenter 
ServiceCenter Required: No Service center container. 


Type: Container 
Max Allowed: UNB 


Length: N/A 
/TrackResponse/Shipment/ServiceCenter/Type 
Type Required: Yes* The type ofservice center for 
Type:Container _ freightshipment. 
Max Allowed: 1 
Length: N/A 
/TrackResponse/Shipment/ServiceCenter/Type/Code 
Code Required: Yes* Service Center typecodes: 
Type: String 01 - Delivery Service Center 


02 - Estimated Delivery Service 
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Max Allowed: 1 
Length:2 


Center 
03 - Pickup Service Center 


/TrackResponse/Shipment/ServiceCenter/Type/Description 


Description Required: Yes* 
Type: String 
Max Allowed: 1 


Length: 1..35 


Description of the code above. 


/TrackResponse/Shipment/ServiceCenter/Address 


Address Required: Yes* 
Type: Container 
Max Allowed: 1 


Length: N/A 


Service center address. 


/TrackResponse/Shipment/ServiceCenter/Address/City 


City Required: Yes* 
Type: String 
Max Allowed: 1 


Length: 1..30 


Service center city. 


/TrackResponse/Shipment/ServiceCenter/Address/StateProvinceCode 


StateProvinceCode Required: Yes* 
Type: String 
Max Allowed: 1 


Length: 2..6 


Service Center State or 
provincecode. 


/TrackResponse/Shipment/DeliveryDateUnavailable 


DeliveryDateUnavailabl Required: No 

e Type: Container 
Max Allowed: 1 
Length: N/A 


DeliveryDate Unavailable 
container. 

Note: This container is return if 
SubVersion is 0114 and above. 


/TrackResponse/Shipment/DeliveryDateUnavailable/Type 


Type Required: Yes* 
Type: String 
Max Allowed: 1 


Length: 1..19 


Typeis Scheduled Delivery. 


/TrackResponse/Shipment/DeliveryDateUn available/Description 


Description Required: Yes* 
Type: String 
Max Allowed: 1 
Length: 1..73 

/TrackResponse/Shipment/DeliveryDetail 

Delivery Detail Required: No 


Type: Container 
Max Allowed: UNB 
Length: N/A 


A descriptionis return to 
indicate the scheduled delivery 
date is unavailable 


Delivery detail information. 


/TrackResponse/Shipment/DeliveryDetail/Type 


Type Required: Yes* 
Type: Container 
Max Allowed: 1 


Length: N/A 


Type of delivery detail. 


/TrackResponse/Shipment/DeliveryDetail/Type/Code 


Code Required: Yes* 
Type: String 
Max Allowed: 1 


Length:2 


Delivery Detail codes. 


/TrackResponse/Shipment/DeliveryDetail/Type/Description 


Valid values: 

01 - Delivery 

02- Estimated Delivery 
03 - Scheduled Delivery 


For Mail Innovationsonly 01 
and02 apply. 
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Description Required: Yes* 
Type: String 
Max Allowed: 1 
Length: 1..35 


Description of above code. 


/TrackResponse/Shipment/DeliveryDetail/Date 


Date Required: Yes* 
Type: String 
Max Allowed: 1 
Length:8 


Date for the specific delivery 
type. Format: YYYYMMDD 


/TrackResponse/Shipment/DeliveryDetail/Time 


Time Required: Yes* 
Type: String 
Max Allowed: 1 
Length:6 

/TrackResponse/Shipment/Volume 

Volume Required: No 
Type: Container 
Max Allowed: 1 
Length: N/A 


Time for the specific delivery 
type. Format: HHMMSS. 


Container for the volume of 
freight Shipment. 


/TrackResponse/Shipment/Volume/UnitOfMeasurement 


UnitOfMeasurement Required: Yes* 
Type: Container 
Max Allowed: 1 
Length: N/A 


Unit of measurement container. 


/TrackResponse/Shipment/Volume/UnitOfMeasurement/Code 


Code Required: Yes* 
Type: String 
Max Allowed: 1 
Length:2 


Code indicating the unit of 
measurement for the volume. 


/TrackResponse/Shipment/Volume/UnitOfMeasurement/Description 


Description Required: Yes* 
Type: String 
Max Allowed: 1 
Length: 1..35 


/TrackResponse/Shipment/Volume/Value 


Value Required: Yes* 
Type: String 
Max Allowed: 1 
Length: 1..35 

/TrackResponse/Shipment/BillToName 

BillToName Required: No 
Type: String 
Max Allowed: 1 
Length: 1..35 


Description of the unit of 
measurement as indicated by 
code. 


Value ofthe total volume ofthe 
shipment. 


Name of the person to whom 
the shipmentis billed to. 


/TrackResponse/Shipment/NumberOfPackagingUnit 


NumberOfPackagingU Required: No 

nit Type: Container 
Max Allowed: UNB 
Length: N/A 


Number of packaging unit. 


/TrackResponse/Shipment/NumberOfPackagingUnit/Type 


Type Required: Yes* 
Type: Container 
Max Allowed: 1 
Length: N/A 


Type of packaging 


/TrackResponse/Shipment/NumberOfPackagin gUnit/Type/Code 
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Code Required: Yes* 
Type: String 
Max Allowed: 1 
Length:2 


Packaging unitcodes: 
01 - Piece 
02 — Pallet 


/TrackResponse/Shipment/NumberOfPackagingUnit/Type/Description 


Description Required: Yes* 
Type: String 
Max Allowed: 1 
Length: 1..35 


Description of the above code. 


/TrackResponse/Shipment/NumberOfPackagingUnit/Value 


Value Required: Yes* 
Type: String 
Max Allowed: 1 
Length: 1..15 

/TrackResponse/Shipment/COD 

COD Required: No 
Type: Container 
Max Allowed: 1 
Length: N/A 

/TrackResponse/Shipment/COD/Amount 

Amount Required: Yes* 
Type: Container 
Max Allowed: 1 
Length: N/A 


The actual number of unit. 


Container for COD for the 
shipment. 


Container for COD amount 


/TrackResponse/Shipment/COD/Amo unt/CurrencyCode 


CurrencyCode Required: Yes* 
Type: String 
Max Allowed: 1 


Length:3 


Currency Code for COD. 
Default value isUSD 


/TrackResponse/Shipment/COD/Amount/Monetary Value 


Monetary Value Required: Yes* 
Type: String 
Max Allowed: 1 


Length: 1..30 
/TrackResponse/Shipment/COD/Status 


Status Required: N/A 
Type: Container 
Max Allowed: 1 
Length: N/A 


Cash On Delivery (COD) 
Amount that is due. 


/TrackResponse/Shipment/Sig ned ForByName 


Signed ForByName Required: No 


Type: String 

Max Allowed: 1 

Length: 1..35 
/TrackResponse/Shipment/Activity 
Activity Required: No 


Type: Container 
Max Allowed: UNB 
Length: N/A 


Person that received the 
shipment. May be the 
addressee, or another person 
that signed for the shipment 


Container for shipment activity. 


/TrackResponse/Shipment/Activity/Activity Location 


ActivityLocation Required: Yes* 
Type: Container 
Max Allowed: 1 


Length: N/A 


Container for shipment activity 
location 


/TrackResponse/Shipment/Activity/Activity Location/City 
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City Required: Yes* 
Type: String 
Max Allowed: 1 
Length: 1..30 


Activity city. 


/TrackResponse/Shipment/Activity/ActivityLocation/StateProvinceCode 


StateProvinceCode Required: Yes* 
Type: String 
Max Allowed: 1 
Length: 2..5 


Activity State or province code. 


/TrackResponse/Shipment/Activity/ActivityLo cation/PostalCode 


PostalCode Required: Yes* 
Type: String 
Max Allowed: 1 
Length: 5..16 


Activity postal code 


/TrackResponse/Shipment/Activity/Activity_Location/CountryCode 


CountryCode Required: Yes* 
Type: String 
Max Allowed: 1 
Length:2 


Activity country or territory code 


/TrackResponse/Shipment/Activity/Description 


Description Required: Yes* 
Type: String 
Max Allowed: 1 
Length: 1..370 


/TrackResponse/Shipment/Activity/Date 


Date Required: Yes* 
Type: String 
Max Allowed: 1 
Length:8 


/TrackResponse/Shipment/Activity/Time 


Time Required: Yes* 
Type: String 
Max Allowed: 1 
Length:6 


/TrackResponse/Shipment/Activity/Trailer 


Trailer Required: Yes* 
Type: String 
Max Allowed: 1 
Length: 1..30 

/TrackResponse/Shipment/Origin PortDetail 

OriginPortDetail Required: No 
Type: Container 
Max Allowed: 1 
Length: N/A 


Description of the Activity. 


Activity Date. Format: 
YYYYMMDD 


Activity Time. Format: 
HHMMSS 


Trailer Code for the shipment 


Details oforigin portofthe 
shipment. 


/TrackResponse/Shipment/Origin PortDetail/OriginPort 


OriginPort Required: Yes* 
Type: String 
Max Allowed: 1 
Length: 1..35 


Origin Portofthe shipment. 


/TrackResponse/Shipment/OriginPortDetail/Estimated Departure 


Estimated Departure Required: Yes* 
Type: Container 
Max Allowed: 1 
Length: N/A 


Container for Estimated 
Departure Time Stamp at the 
origin port. 


/TrackResponse/Shipment/OriginPortDetail/Estimated Dep arture/Date 
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Date Required: Yes* Date of the Estimated Departure 
Type: String Time Stamp at the origin port. 
Max Allowed: 1 Format: YYYYMMDD 
Length:8 
/TrackResponse/Shipment/OriginPortDetail/Estimated Dep arture/Time 
Time Required: Yes* Time of the Estimated FRT 
Type: String Departure Time Stamp at the 
Max Allowed: 1 origin port. Format: HHMMSS 
Length:6 
/TrackResponse/Shipment/Destin atio nPortDetail 
DestinationPortDetail | Required: No Container for the destination FRT 
Type: Container | portofthe shipment. 
Max Allowed: 1 
Length: N/A 
/TrackResponse/Shipment/Destin atio nPortDetail/Destinatio nPort 
DestinationPort Required: Yes* Destination portofthe FRT 
Type: String shipment. 
Max Allowed: 1 
Length: 1..35 
/TrackResponse/Shipment/DestinationPo nDetail/Estimated Arrival 
EstimatedArrival Required: Yes* Container for Estimated Arrival FRT 


Type:Container Time Stamp atthe Destination 
Max Allowed: 1 Port 


Length: N/A 

/TrackResponse/Shipment/Destin atio nPortDetail/EstimatedArrival/Date 

Date Required: Yes* Container for Estimated Arrival FRT 
Type: String Time Stamp at the Destination 
Max Allowed: 1 Port. Format: YYYYMMDD 
Length:8 

/TrackResponse/Shipment/Destin atio nPortDetail/EstimatedArrival/Time 

Time Required: Yes* Time of the Estimated Arrival FRT 
Type: String Time Stamp at the Destination 
Max Allowed: 1 Port. Format: HHMMSS 
Length:6 

/TrackResponse/Shipment/DescriptionOfGoods 

DescriptionOfGoods Required: No Description of Goods in the FRT 
Type: String shipment. 
Max Allowed: 1 


Length: 1..512 
/TrackResponse/Shipment/CargoReady 


CargoReady Required: No Container for cargo ready date FRT 
Type:Container — and time. 
Max Allowed: 1 
Length: N/A 

/TrackResponse/Shipment/CargoReady/Date 

Date Required: Yes* Cargo Ready date for the FRT 
Type: String shipment. Format: YYYYMMDD 
Max Allowed: 1 
Length:8 

/TrackResponse/Shipment/CargoReady/Time 

Time Required: Yes* Cargo Ready time forthe FRT 
Type: String shipment. Format: HHMMSS 
Max Allowed: 1 
Length:6 


/TrackResponse/Shipment/Manifest 
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Manifest Required: No 
Type: Container 
Max Allowed: 1 
Length: N/A 


/TrackResponse/Shipment/Manifest/Date 


Date Required: Yes* 
Type: String 
Max Allowed: 1 
Length:8 


/TrackResponse/Shipment/Manifest/Time 
Time Required: Yes* 
Type: String 
Max Allowed: 1 
Length:6 


Container for Manifest date and 
time. 


Manifest date for the shipment. 
Format: YYYYMMDD 


Manifest time for the shipment. 
Format: HHMMSS 


/TrackResponse/Shipment/CarrierActivity Information 


CarrierActivityInformati | Required: Yes* 
on Type: Container 


Max Allowed: UNB 


Length: N/A 


Container for carrier activity 
information for the shipment. 


/TrackResponse/Shipment/CarrierActivity Information/Carrierld 


Carrierld Required: Yes* 
Type: String 
Max Allowed: 1 
Length: 1..30 


Id number of the carrier 


/TrackResponse/Shipment/CarrierActivity Information/Description 


Description Required: Yes* 
Type: String 
Max Allowed: 1 
Length: 1..35 


Description of the carrier e.g: 
Flightor Vessel. 


/TrackResponse/Shipment/CarrierActivity Information/Status 


Status Required: Yes* 
Type: String 
Max Allowed: 1 
Length: 1..35 


Status of the carrier 


/TrackResponse/Shipment/CarrierActivity Information/Arrival 


Arrival Required: Yes* 
Type: Container 
Max Allowed: 1 
Length: N/A 


Container for arrival time stamp 
information of the carrier 


/TrackResponse/Shipment/CarrierActivityInformation/Arrival/Date 


Date Required: Yes* 
Type: String 
Max Allowed: 1 
Length:8 


Date ofthe arrival time stamp. 
Format: YYYYMMDD 


/TrackResponse/Shipment/CarrierActivity Information/Arrival/Time 


Time Required: Yes* 
Type: String 
Max Allowed: 1 
Length:6 


Time of the arrival time stamp. 
Format: HHMMSS 


/TrackResponse/Shipment/CarrierActivity Information/Dep arture 


Departure Required: Yes* 
Type: Container 
Max Allowed: 1 
Length: N/A 


Container for Departure time 
stamp information ofthe carrier 


/TrackResponse/Shipment/CarrierActivity Information/Dep arture/Date 
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Date Required: Yes* Date ofthe arrival time stamp. 
Type: String Format: YYYYMMDD 
Max Allowed: 1 
Length:8 
/TrackResponse/Shipment/CarrierActivity Information/Dep arture/Time 
Time Required: Yes* Time of the arrival time stamp. FRT 
Type: String Format: HHMMSS 
Max Allowed: 1 
Length:6 
/TrackResponse/Shipment/CarrierActivity Information/OriginPort 
OriginPort Required: Yes* Origin Port of the Carrier's leg of FRT 
Type: String the journey 
Max Allowed: 1 
Length: 1..30 
/TrackResponse/Shipment/CarrierActivity Information/DestinationPort 
DestinationPort Required: Yes* Destination Port ofthe Carrier's FRT 
Type: String leg of the journey 
Max Allowed: 1 
Length: 1..30 
/TrackResponse/Shipment/Document 
Document Required: Yes* Container for the various Freight Signature Tracking only. FRT SIG 


Type: Container | documents returned to the 

Max Allowed: UNB_ customer. 

Length: N/A 
Returned if Signature Tracking 
is enabled and authorized. 
Returned if any of the 
documents i.e., Signature, Free 
Astrays, Delivery Receiptor 
POD is requested using the 
request option. 
Not returned for documents like 
SCS Freight, UPS Freight 
TULTL. 


Refer to the Request Option 
Matrix in the Appendix. 


/TrackResponse/Shipment/Document/Type 


Type Required: Yes* Container for the document Freight Signature Tracking only. FRT SIG 
Type:Container _ type. 
Max Allowed: 1 
Length: N/A 

/TrackResponse/Shipment/Document/Type/Code 

Code Required: Yes* Code for the type of the Freight Signature Tracking only. FRT SIG 
Type: String document. 
Max Allowed: 1 
Length:2 01 - Signature Image 


02 - Delivery Receipt 
03 - Free Astray 


04 - POD 
/TrackResponse/Shipment/Document/Type/Description 
Description Required: Yes* Description for the type of the Freight Signature Tracking only. FRT SIG 
Type: String documentas described by the 
Max Allowed: 1 code. 
Length: 1..35 
/TrackResponse/Shipment/Document/Content 
Content Required: Yes* Base64 Encoded Byte stream of Freight Signature Tracking only. FRT SIG 
Type: String the image. 
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Max Allowed: 1 
Length: Image 


/TrackResponse/Shipment/Document/Format 


Format Required: Yes* Container for the document Freight Signature Tracking only. FRT SIG 
Type:Container — format. 
Max Allowed: 1 
Length: N/A 

/TrackResponse/Shipment/Document/Format/Code 

Code Required: Yes* Code forthe documentformat. | Freight Signature Tracking only. FRT SIG 
Type: String 
Max Allowed: 1 Values: 01 - GIF, 02 - PDF 
Length:2 

/TrackResponse/Shipment/Document/Format/Description 

Description Required: Yes* Description of the document Freight Signature Tracking only. FRT SIG 
Type: String format as indicated by the code. 
Max Allowed: 1 
Length: 1..35 

/TrackResponse/Ship ment/FileNumber 

FileNumber Required: Yes* File Number of the shipment. FRT 
Type: String 
Max Allowed: 1 
Length: 1..30 

/TrackResponse/Shipment/Appointment 

Appointment Required: No Appointment Details. FRT 
Type: Container 
Max Allowed: 1 
Length: N/A 

/TrackResponse/Shipment/Appointment/Made 

Made Required: Yes* Container for Appointment FRT 
Type:Container | Made Date and Time. 
Max Allowed: 1 
Length: N/A 

/TrackResponse/Shipment/App ointment/Made/Date 

Date Required: Yes* Appointment Made Date. FRT 
Type: String Format: YYYYMMDD 
Max Allowed: 1 
Length:8 

/TrackResponse/Shipment/Ap pointment/Made/Time 

Time Required: Yes* Appointment Made Time. FRT 
Type: String Format: HHMMSS 
Max Allowed: 1 
Length:6 

/TrackResponse/Shipment/Ap pointment/Requested 

Requested Required: Yes* Container for Appointment FRT 
Type:Container | Requested Date and Time 
Max Allowed: 1 
Length: N/A 

/TrackResponse/Shipment/App ointment/Requested/Date 

Date Required: Yes* Appointment Requested Date. FRT 
Type: String Format: YYYYMMDD 
Max Allowed: 1 
Length:8 

/TrackResponse/Shipment/Ap pointment/Requested/Time 

Time Required: Yes* Appointment Requested Time. FRT 
Type: String Format: HHMMSS 
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Max Allowed: 1 
Length:6 


/TrackResponse/Shipment/Ap pointment/Beg in Time 


BeginTime Required: Yes* 
Type: String 
Max Allowed: 1 
Length:6 


Appointment Begin Time. 
Format: HHMMSS 


/TrackResponse/Shipment/App ointment/EndTime 


EndTime Required: Yes* 
Type: String 
Max Allowed: 1 
Length:6 

/TrackResponse/Shipment/Package 

Package Required: No 


Type: Container 
Max Allowed: UNB 
Length: N/A 


Appointment End Time. Format: 


HHMMSS 


Container for package 
information. 


/TrackResponse/Shipment/Package/Tracking Number 


Tracking Number Required: Yes* 
Type: String 
Max Allowed: 1 


Length: 1..34 


TrackingNumber ofthe 
package. 


/TrackResponse/Shipment/Package/Deliverylndicator 


Deliverylndicator Required: Yes* 
Type: String 
Max Allowed: 1 


Length: 1..34 


Indicates if the currentpackage 
is delivered. Possible Values: 
"Y": Package is delivered 

"N": Package is notdelivered 


/TrackResponse/Shipment/Package/DeliveryDate 


Tracking Number Required: Yes* 
Type: String 
Max Allowed: 1 


Length: 1..34 


The delivery date ofthe 
package. Will be returned if 
delivery date indicatoris Y. The 
format is: YYYYMMDD 


/TrackResponse/Shipment/Package/SRSizeCode 


SRSizeCode Required: No 
Type: String 
Max Allowed: 1 
Length: 1..2 


Simple Rate package size. 
Valid Values: 

XS 

S 

M 

L 

XL 

Note: This container is returned 
if SubVersion is 1909 or above 


/TrackResponse/Shipment/Package/Redirect 


Redirect Required: Yes* 
Type: Container 
Max Allowed: 1 
Length: N/A 


Container tag for Redirect 
package to UPS Access Point 
Note: This container is return if 
SubVersion is 0114 or above 


/TrackResponse/Shipment/Packag e/Redirect/CompanyName 


CompanyName Required: Yes* 
Type: String 
Max Allowed: 1 


Length: 1..35 


UPS Access Point Business 
Name. 


/TrackResponse/Shipment/Package/Redirect/LocationID 


LocationID Required: Yes* 
Type: String 
Max Allowed: 1 
Length: 1..9 
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/TrackResponse/Shipment/Package/Redirect/PickupDate 


Pickup Date Required: Yes* The last date the packageis PKG 
Type: String held for pickup ata UPS Access 
Max Allowed: 1 Point. Date ofthe arrival time 
Length:8 stamp. 


Format: YYYYMMDD 
/TrackResponse/Shipment/Package/DeliveryDetail 


Delivery Detail Required: Yes* Delivery Detail container. PKG 
Type: Container 
Max Allowed: UNB 


Length: N/A 

/TrackResponse/Shipment/Package/DeliveryDetail/Type 

Type Required: Yes* Type of delivery detail. PKG 
Type: Container 
Max Allowed: 1 
Length: N/A 

/TrackResponse/Shipment/Package/DeliveryDetail/Type/Code 

Code Required: Yes* Delivery detail Type code: 04 — PKG 
Type: String Rescheduled Delivery 
Max Allowed: 1 
Length:2 

/TrackResponse/Shipment/Package/DeliveryDetail/Type/Description 

Description Required: Yes* Description of above code PKG 
Type: String above. 
Max Allowed: 1 
Length: 1..35 

/TrackResponse/Shipment/Package/DeliveryDetail/Date 

Date Required: Yes* The delivery date. Format: PKG 
Type: String YYYYMMDD (military format) 
Max Allowed: 1 
Length:8 

/TrackResponse/Shipment/Package/DeliveryDetail/Time 

Time Required: Yes* Format: HHMMSS or HHMM PKG 
Type: String (military format) 
Max Allowed: 1 


Length:4 or6 
/TrackResponse/Shipment/Package/PackageAddress 


PackageAddress Required: No Package address container. PKG 
Type: Container 
Max Allowed: UNB 
Length: N/A 


/TrackResponse/Shipment/Package/PackageAddress/Type 


Type Required: Yes* Type of thepackage address PKG 
Type: Container 
Max Allowed: 1 
Length: N/A 
/TrackResponse/Shipment/Package/PackageAddress/Type/Code 
Code Required: Yes* Package Address Typecode. Valid values: PKG 
Type: String 03 — ReRoute Address 
Max Allowed: 1 04 — ReturnTo Address 
Length:2 05 — UPS AP Address 
/TrackResponse/Shipment/Package/Packag eAddress/Type/Description 
Description Required: Yes* Description of the code above. PKG 
Type: String 
Max Allowed: 1 
Length: 1..35 
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/TrackResponse/Shipment/Package/Packag eAddress/Address 


Address Required: Yes* Address Container. PKG 
Type: Container 
Max Allowed: 1 
Length: N/A 
/TrackResponse/Shipment/Package/PackageAddress/Address/AddressLine 
AddressLine Required: Yes* Street address including name PKG 
Type: String and number (when applicable) 
Max Allowed: 3 and/or building floor, room, 
Length: 1..50 suite, and PO Box number. Up 
to three AddressLines can be 
returned. 
/TrackResponse/Shipment/Package/PackageAddress/Address/City 
City Required: Yes* City name. PKG 
Type: String 
Max Allowed: 1 
Length: 1..30 
/TrackResponse/Shipment/Packag e/Packag eAddress/Address/StateProvinceCode 
StateProvinceCode Required: Yes* State or Province code. PKG 
Type: String 
Max Allowed: 1 
Length:2..5 
/TrackResponse/Shipment/Packag e/PackageAddress/Address/PostalCode 
PostalCode Required: Yes* Postal code. PKG 
Type: String 
Max Allowed: 1 
Length: 5..16 
/TrackResponse/Shipment/Package/Packag eAddress/Address/Country Code 
CountryCode Required: Yes* Country or territory code. PKG 
Type: String 
Max Allowed: 1 
Length:2 
/TrackResponse/Shipment/Package/PackageServiceOption 
PackageServiceOption Required: No Container for package service PKG 


Type:Container — option. 
Max Allowed: UNB 
Length: N/A 


/TrackResponse/Shipment/Package/PackageServiceOption/Type 


Type Required: Yes* Type of package service option PKG 
Type: Container 
Max Allowed: 1 
Length: N/A 

/TrackResponse/Shipment/Package/Packag eServiceOption/Type/Code 

Code Required: Yes Package Service code. For values, see Package PKG 
Type: String Service Option Codes inthe 
Max Allowed: 1 Appendix. 
Length: 2..3 

/TrackResponse/Shipment/Package/Packag eServiceOption/Type/Description 

Description Required: Yes* Description of the code above. PKG 
Type: String 
Max Allowed: 1 
Length: 1..100 


/TrackResponse/Shipment/Package/Packag eServiceOption/Value 


Value Required: Yes* PackageServiceOption Type PKG 
Type: String Code values: 
Max Allowed: 1 04 =R — Commercial Invoice 


Length: 1..100 Removal Requested or S — 
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/TrackResponse/Shipment/Package/COD 

COD Required: No 
Type: Container 
Max Allowed: 1 
Length: N/A 


Commercial Invoice Removal 
Success. 

06 = USPS Package 
Identification number thatis 
returned for UPS Returns 
Flexible Access Shipments. 
07 = The specific product 
description. 

09 = R — Return Exchange 
Requested or S— Exchange 
Completed. 


COD container atpackage 
level. 

Refer to the Request Option 
Matrix in the Appendix. 


/TrackResponse/Shipment/Package/COD/Amount 


Amount Required: Yes* 
Type: Container 
Max Allowed: 1 


Length: N/A 


Container for COD amount 
information. 


/TrackResponse/Shipment/Package/COD/Amount/CurrencyCode 


CurrencyCode Required: Yes* 
Type: String 
Max Allowed: 1 


Length:3 


Currency code of COD amount. 


/TrackResponse/Shipment/Package/COD/Amount/Monetary Value 


Monetary Value Required: Yes* 
Type: String 
Max Allowed: 1 


Length: 11 


Cash On Delivery (COD) 
Amount that is due. 


/TrackResponse/Shipment/Package/COD/Status 


Status Required: Yes* 
Type: Container 
Max Allowed: 1 


Length: N/A 


Container for COD status. 


/TrackResponse/Shipment/Package/COD/Status/Code 


Code Required: Yes* 
Type: String 
Max Allowed: 1 


Length: 1 


Status code of whether COD 


was received. Values: 


Collected 
Not Collected 


/TrackResponse/Shipment/Package/COD/ControlNumber 


ControlINumber Required: Yes* 
Type: String 
Max Allowed: 1 


Length: 1..50 


/TrackResponse/Shipment/Package/Activity 


Activity Required: No 
Type: Container 
Max Allowed: UNB 


Length: N/A 


Barcode COD Control Number 
or UPS imprinted Control 
Number. 


Package activity container 


/TrackResponse/Shipment/Package/Activity/Alternate Tracking Info 


AlternateTrackingInfo | Required: Yes* 
Type: Container 
Max Allowed: UNB 


Length: N/A 


Alternate tracking number. 


/TrackResponse/Shipment/Package/Activity/AlternateTracking Info/Type 


Package Signature Tracking 
only. 


Package Signature Tracking 
only. 


Package Signature Tracking 
only. 


Package Signature Tracking 
only. 


Package Signature Tracking 
only. 


Package Signature Tracking 
only. 


Package Signature Tracking 
only. 


Mail Innovationsonly. 
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Type Required: Yes* 
Type: String 
Max Allowed: 1 


Length: 1 


Valid values: 

P — Package ID 

M-— Mail Manifest ID (typeof 
Sequence number) 

S — MMS number(type of 
Sequence number) 

T- Postal service Tracking ID 
Q — Intelligent Mail Package 
Barcode shipment (IMPB) 
number 


Package Activity Alternate 
Tracking info type. 


/TrackResponse/Shipment/Package/Activity/Altern ateTracking Info/Value 


Value Required: Yes* 
Type: String 
Max Allowed: 1 


Length: 1..35 


This contains value ofthe 
alternate tracking number. 


/TrackResponse/Shipment/Package/Activity/ActivityLocation 


ActivityLocation Required: No 
Type: Container 
Max Allowed: 1 


Length: N/A 


Activity location container. 


/TrackResponse/Shipment/Package/Activity/Activity_Location/Address 


Address Required: Yes* 
Type: Container 
Max Allowed: 1 


Length: N/A 


For Mail Innovations this will be 
consignee location. 


Address of Activity location. 


/TrackResponse/Shipment/Package/Activity/Activity_Location/Address/AddressLine 


AddressLine Required: Yes* 
Type: String 
Max Allowed: 3 


Length: 1..30 


Activity location’s street address 
including name and number 
(when applicable) and/or 
building floor, room, suite, and 
PO Box number. Up to three 
AddressLine can be returned. 


/TrackResponse/Shipment/Package/Activity/Activity_Location/Address/City 


City Required: Yes* 
Type: String 
Max Allowed: 1 


Length: 1..30 


City name. This is optional for 
Mail Innovations 


/TrackResponse/Shipment/Package/Activity/Activity_Location/Address/StateProvinceCode 


StateProvinceCode Required: Yes* 
Type: String 
Max Allowed: 1 


Length: 2..5 


Activity location’s state or 
province code. This is optional 
for Mail Innovations. 


/TrackResponse/Shipment/Package/Activity/ActivityLocation/Address/PostalCode 


PostalCode Required: Yes* 
Type: String 
Max Allowed: 1 


Length: 5..16 


Activity locations postal code. 


/TrackResponse/Shipment/Package/Activity/Activity_Location/Address/CountryCode 


CountryCode Required: Yes* 
Type: String 
Max Allowed: 1 


Length:2 


Activity locations country or 
territory code. 


/TrackResponse/Shipment/Package/Activity/Activity_Location/TransportFacility 


TransportFacility Required: No 
Type: Container 
Max Allowed: 1 


Length: N/A 


This container is for storing the 
type and code ofthe transport 

facility associated with the Mail 
Innovations activity. 
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/TrackResponse/Shipment/Package/Activity/Activity Location/Tran sp ortFacility/Type 


Type Required: Yes* Type of facility for Mail Mail Innoviations validvalues: = Ml 
Type: String Innovations shipment. IC — USPS 
Max Allowed: 1 VT -MI 
Length:2 
/TrackResponse/Shipment/Package/Activity/ActivityLocation/Tran sp ortFacility/Code 
Code Required: Yes* This codeis associated with the MI 
Type: String Mail Innovations facility. 
Max Allowed: 1 
Length:5 
/TrackResponse/Shipment/Package/Activity/ActivityLocation/Code 
Code Required: Yes* Activity location code. PKG 
Type: String 
Max Allowed: 1 
Length:2 
/TrackResponse/Shipment/Package/Activity/Activity _Location/Description 
Description Required: Yes* Activity location description. PKG 
Type: String 
Max Allowed: 1 
Length: 1..35 
/TrackResponse/Shipment/Package/Activity/Activity Location/Signed ForByName 
Signed ForByName Required: No Name of the person who PKG 
Type: String signed. 
Max Allowed: 1 
Length: 1..50 
/TrackResponse/Shipment/Package/Activity/Status 
Status Required: No Container for activity status. PKG, MI 
Type: Container 
Max Allowed: 1 
Length: N/A 
/TrackResponse/Shipment/Package/Activity/Status/Type 
Type Required: Yes* Type of activity status: For Mail Innovationsonly D, |, PKG, MI 
Type: String | = In Transit M, P and X are applicable. 
Max Allowed: 1 D = Delivered 
Length: 1..3 X = Exception 
P = Pickup 


M = Manifest Pickup. 
/TrackResponse/Shipment/Package/Activity/Status/Description 


Description Required: Yes* Description of status code of PKG, MI 
Type: String activity. 
Max Allowed: 1 


Length: 1..370 
/TrackResponse/Shipment/Package/Activity/Status/Code 


Code Required: Yes* Status code of activity. PKG, MI 
Type: String 
Max Allowed: 1 
Length:2 

/TrackResponse/Shipment/Package/Activity/Date 


Date Required: Yes* Date of activity. PKG, MI 
Type: String Military format: YYYYMMDD 
Max Allowed: 1 
Length:8 


/TrackResponse/Shipment/Package/Activity/Time 
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Time Required: Yes* 
Type: String 
Max Allowed: 1 


Length: 4..6 


Time of activity. 
Military format: HHMMSS or 
HHMM 


/TrackResponse/Shipment/Package/Activity/GMT Date 


GMTDate Required: No 
Type: String 
Max Allowed: 1 


Length:8 


Date of activity. 

Format: YYYY-MM-DD 

Note: This container is return if 
SubVersion is 1907 or above 


/TrackResponse/Shipment/Package/Activity/GMT Time 


GMTTime Required: No 
Type: String 
Max Allowed: 1 


Length:6 


Time of activity. 

Format: hh:mm:ss or hh:mm 
Note: This container is return if 
SubVersion is 1907 or above 


/TrackResponse/Shipment/Package/Activity/GMT Offset 


GMT Offset Required: No 
Type: String 
Max Allowed: 1 


Length: 6 


GMT Offset of activity for the 
time zone. 

Format: (+/-) hh:mm 

Note: This container is return if 
SubVersion is 1907 or above 


/TrackResponse/Shipment/Package/Activity/Delivery DateFromManifestIndicator 


DeliveryDateFromManif Required: No 

estIndicator Type: String 
Max Allowed: 1 
Length: N/A 


The presence of this indicator 
means manifest informationis 
available and used to calculate 
the expected delivery date. 
This will be available when 
Track sub version >=1507 


/TrackResponse/Shipment/Package/Activity/NextScheduleActivity 


NextScheduleActivity | Required: No 
Type: Container 
Max Allowed: 1 


Length: N/A 


Container tag to describe when 
the next schedule activity will 
occur. 

Note: This container is return if 
SubVersion is 0114 and above 


/TrackResponse/Shipment/Package/Activity/NextScheduleActivity/Date 


Date Required: Yes* 
Type: String 
Max Allowed: 1 


Length: N/A 


Date of activity. 
Military format: YYYYMMDD 


/TrackResponse/Shipment/Package/Activity/NextScheduleActivity/Time 


Time Required: Yes* 
Type: String 
Max Allowed: 1 


Length: N/A 


Time of activity. 
Military format: HHMMSS or 
HHMM 


/TrackResponse/Shipment/Package/Activity/Document 


Document Required: No 
Type: Container 
Max Allowed: UNB 


Length: N/A 


Documents at package activity 
level. 
Example: PODLetter 


Signature image 


Refer to the Request Option 
Matrix in the Appendix. 


/TrackResponse/Shipment/Package/Activity/Document/Type 


Type Required: Yes* 
Type: Container 
Max Allowed: 1 


Length: N/A 


Type of Document. 


/TrackResponse/Shipment/Package/Activity/Document/Type/Code 
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Code Required: Yes* 
Type: String 
Max Allowed: 1 


Length:2 


Document Type code. 
04 — POD Letter 
05 — Electronic Delivery Letter 


Signature Tracking valid value: 
01 — Signature Image 


“Returned if customer has 
authorized release ofthe 
package with the signature. 


/TrackResponse/Shipment/Package/Activity/Document/Type/Description 


Description Required: Yes* 
Type: String 
Max Allowed: 1 


Length: 1..35 


Description of the code above. 


/TrackResponse/Shipment/Package/Activity/Document/Content 


Content Required: Yes* 
Type: String 
Max Allowed: 1 
Length: Variable 


Base64 Encoded PODLetter in 
html format or the customer’s 
name for Electronic Delivery 
Notice. 


Signature Tracking only: 
Base64 Encoded GIF image for 
signature image. 


/TrackResponse/Shipment/Package/Activity/Document/Format 


Format Required: Yes* 
Type: Container 
Max Allowed: 1 


Length: N/A 


Container for document format. 


/TrackResponse/Shipment/Package/Activity/Document/Format/Code 


Code Required: Yes 
Yes* 

Type: String 
Max Allowed: 1 
Length:3 


Format code ofthe content. Signature Tracking valid value: 


/TrackResponse/Shipment/Package/Activity/Document/Format/Description 


Description Required: Yes* 
Type: String 
Max Allowed: 1 


Length: 1..35 


/TrackResponse/Shipment/Package/Activity/SensorEventlndicator 


SensorEventindicator Required: Yes* 
Type: String 
Max Allowed: UNB 


Length: 1 


/TrackResponse/Shipment/Package/Message 


Message Required: No 
Type: Container 
Max Allowed: UNB 


Length: N/A 


/TrackResponse/Shipment/Package/Messag e/Code 


Code Required: Yes* 
Type: String 
Max Allowed: 1 


Length:2 


03 — HTML 01 — GIF 

04 — Plain text 

Description of Formatcode 

above. 

Plain text format will only apply 

if the code aboveis 04. 

Indicates ifthe activity hasa 

sensor event associated with it. 

Valid values: 

Y 

N 

Container for additional delivery 

information. 

Code describing what type of Valid values: 
message the customer can 01 —On Time 


02 — Rescheduled 
03 — Returned To Shipper 


receive. 


For Mail Innovations only01 is 
applicable. 


/TrackResponse/Shipment/Package/Messag e/Description 


Description Required: Yes* 
Type: String 
Max Allowed: 1 


Length: 1..50 


Description for the code above. 
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/TrackResponse/Shipment/Package/Packag eWeight 


PackageWeight Required: No Container for package weight. PKG, MI 
Type: Container 
Max Allowed: 1 
Length: N/A 
/TrackResponse/Shipment/Package/PackageWeight/UnitOfMeasurement 
UnitOfMeasurement Required: Yes* Container for package weight PKG, MI 
Type:Container — unitof measurement. 
Max Allowed: 1 
Length: N/A 
/TrackResponse/Shipment/Package/PackageWeight/UnitOfMeasurement/Code 
Code Required: Yes* Package weight unit of Valid values: PKG, MI 
Type: String measurement code. LBS — Pounds (default) 
Max Allowed: 1 KGS — Kilograms 
Length:3 OZS — Ounces 
/TrackResponse/Shipment/Package/Packag eWeight/UnitOfMeasurement/Description 
Description Required: Yes* Description of the package PKG, MI 
Type: String weight measurement units. 
Max Allowed: 1 
Length: 1..35 
/TrackResponse/Shipment/Package/PackageWeight/Weight 
Weight Required: Yes* Packages weight. Set to 0 for PKG, MI 
Type: String package type of letters. 
Max Allowed: 1 
Length: 7 


/TrackResponse/Shipment/Package/ReferenceNumber 


ReferenceNumber Required: No Container for package reference PKG, MI 
Type: Container = number. Up to 20 reference 
Max Allowed: UNB_ numbers can be returned. 


Length: N/A 
/TrackResponse/Shipment/Package/ReferenceNumber/Code 
Code Required: Yes* Package Reference number For valid values, see Reference | PKG, MI 
Type: String typecode. The codespecifies | Number Codes in the Appendix. 
Max Allowed: 1 the Reference name. 
Length:2 
/TrackResponse/Shipment/Package/ReferenceNumber/Value 
Value Required: Yes* Customer supplied reference PKG, MI 
Type: String number. 
Max Allowed: 1 
Length: 1..35 
/TrackResponse/Shipment/Package/AlternateT rackin gNumber 
AlternateTrackingNumb) Required: No Alternate tracking number PKG 
er Type: String returned for this package. 


Max Allowed: UNB 
Length: 35..65 


/TrackResponse/Shipment/Package/AlternateT rackin gInfo 


AlternateTrackingInfo | Required: Cond Alternate tracking number Mail Innovationsonly. MI 
Type: Container returned for this package. 
Max Allowed: UNB 


Length: N/A 

/TrackResponse/Shipment/Package/AlternateT rackin gInfo/Type 

Type Required: Yes* Package Alternate Tracking info Valid values: MI 
Type: String type. P — Package ID 
Max Allowed: 1 M -Mail Manifest ID (typeof 
Length: 1 Sequence number) 


S- MMS number (typeof 
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Sequence number) 
T- Postal service Tracking ID 


/TrackResponse/Shipment/Package/AlternateT rackin gInfo/Value 


Value Required: Yes* 
Type: String 
Max Allowed: 1 


Length: 1..34 


This contains value ofthe 
alternate tracking number. 


/TrackResponse/Shipment/Package/DimensionalWeightScan Indicator 


DimensionalWeightSca, Required: No 

nindicator Type: String 
Max Allowed: 1 
Length:0 


Present if Dimensional Weight 
Scan is used to recalculate 
schedule delivery date. 

Note: This Indicator is return if 
SubVersion is 1407 and above. 


/TrackResponse/Shipment/Package/Preautho rized Return Information 


PreauthorizedReturnInf Required: No 

ormation Type: Container 
Max Allowed: 1 
Length: N/A 


Container for the Pre-authorized | This container will be returned 


For Return Information. If this 
information is requested and 
available, then this container will 
be populated for small 
packages and Mail Innovation 
packages. 


only ifthe 
presentin request and Pre- 


information is available. 


/TrackResponse/Shipment/Package/Preautho rized Return Information/Return EligibilityIndicator 


Return Eligibilitylndicato Required: No 

r Type: String 
Max Allowed: 1 
Length: 1 


Contains Eligibility ofthe 
original package to initiate the 
“return process” via the given 
url. 

Valid values are : 

Y — Eligible 

N — Not Eligible 


Valid values are : 
Y - Eligible 
N — Not Eligible 


/TrackResponse/Shipment/Package/Preautho rized Return Information/Return Expir ation Date 


ReturnExpirationDate | Required: No 
Type: String 
Max Allowed: 1 


Length:8 


Contains thelastdate at which YYYYMMDD 
the original package can 
request a “return process’ via 


the given url. 


/TrackResponse/Shipment/Package/Preautho rized Return Information/Return RequestURL 


Return RequestURL Required: No 
Type: String 
Max Allowed: 1 


Length: UNB 


Contains the url that can be 
used to initiate the “return 
process”. 


/TrackResponse/Shipment/Package/Preautho rized Return Information /Original Tracking Number 


OriginalTrackingNumbe) Required: No 

r Type: String 
Max Allowed: 1 
Length: 1...21 


Contains the tracking number of 
the original package. 


/TrackResponse/Ship ment/Packag e/Preauth orized Return Information/Return Tracking Number 


Return TrackingNumber Required: No 
Type: String 
Max Allowed: 1 
Length: 1...21 


Contains the tracking number of 


the return package. 


/TrackResponse/Shipment/Package/UPSPremierAccessorial 


UPSPremierAccessoria Required: No 
| Type: Container 
Max Allowed: 1 


/TrackResponse/Shipment/Package/UPSPremierAccessorial/UPSPremierCode 
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UPSPremierCode Required: No Valid Values: 
Type: String 279 (Silver) 
Max Allowed: 1 278 (Gold) 
Length: N/A 280 (Platinum) 


/TrackResponse/Shipment/Package/UPSPremierAccessorial/UPSPremierDescription 


UPSPremierDescriptio | Required: No Valid Values: PKG 
n Type: String UPS Premier Silver 

Max Allowed: 1 UPS Premier Gold 

Length: N/A UPS Premier Platinum 


Disclaimer 


/TrackResponse/Disclaimer 

Disclaimer Required: No Any necessary or special notice. All 
Type: String 
Max Allowed: UNB 
Length: 1..300 


© 2021 United Parcel Service of America, Inc. All Rights Reserved. Confidential and Proprietary 42 


UPS Tracking Web Service Developer Guide 


June 23, 2021 


Chapter 5: Tracking Web Service API Examples 


Tracking Request 


<soapenv:Envelope xmins:soapenv="http://schemas.xmlsoap.org/soap/envelope/” 
xmins:v1="http:/www.ups.com/XMLSchema/XOLT WS/UPSS/v1.0” 
xmlins:v3="http:/www.ups.com/XMLSchema/XOLTWS/Track/v2.0” 
xmins:v11="http:/Awww.ups.com/XMLSchema/XOLTWS/Common/v1.0"> 


<soapenv:Header> 
<v1:UPSSecurity> 
<v1:UsernameToken> 
<v1:Username>YourUser|lD</v1:Username> 
<v1:Password>YourPassword</v1:Password> 
</v1:UsernameToken> 
<v1:ServiceAccessToken> 
<v1:AccessLicenseNumber>YourLicenseNumber</v1:AccessLicenseNumber> 
</v1:ServiceAccessToken> 
</v1:UPSSecurity> 
</soapenv:Header> 
<soapenv:Body> 
<v3:TrackRequest> 
<v11:Request> 
<v11:RequestOption>1</v11:RequestOption> 
<v11:TransactionReference> 
<v11:CustomerContext>Your Test Case Summary Description</v11:CustomerContext> 
</v11:Transaction Reference> 
</v11:Request> 
<v3:InquiryNumber>YourT racking Number</v3:InquiryNumber> 
</v3:TrackRequest> 
</soapenv:Body> 


</soapenv:Envelope> 
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Track Response 


<?xml version="1.0” encoding="UTF-8”?> 
<soapenv:Envelope xmlins:soapenv="http://schemas.xmlsoap.org/soap/envelope/”> 
<soapenv:Header/> 
<soapenv:Body> 
<trk:TrackResponse xmIns:trk="http :/Awww.ups.com/XMLSchema/XOLTWS/Track/v2.0"> 
<common:Response xmins:common="http:/Awww.ups.com/XMLSchema/XOLTWS/Common/v1.0"> 
<common:ResponseStatus> 
<common:Code>1</common:Code> 
<common:Description>Success</common:Description> 
</common:ResponseStatus> 
<common:TransactionReference> 


<common:CustomerContext>Your Test Case Summary 
Description</common:CustomerContext> 


</common:TransactionReference> 
</common:Response> 
<trk:Shipment> 
<trk:Inquiry Number> 
<trk:Code>01</trk:Code> 
<trk:Description>Shipmentidentification Number</trk:Description> 
<trk:Value>1Z12345E13052779 40</trk:Value> 
</trk:InquiryNumber> 
<trk:ShipmentType> 
<trk:Code>01</trk:Code> 
<trk:Description>Packag e</trk:Description> 
</irk:ShipmentType> 
<trk:ShipperNumber>12345E</trk:ShipperNumber> 
<trk:Service> 
<trk:Code>013</trk:Code> 
<trk:Description>NEXT DAY AIR SAVER</trk:Description> 
</irk:Service> 
<trk:Pickup Date>20100302</trk:Pickup Date> 
<trk:Package> 
<trk:Tracking Number>1Z12345E1305277940</trk: Tracking Number> 
<trk:Activity> 
<trk:ActivityLocation> 
<trk:Address> 
<trk:City>GRAND JUNCTION AIR S</trk:City> 
<trk:StateProvinceCode>CO</trk:StateProvinceCode> 
<trk:CountryCode>US</trk:Country Code> 
</trk:Address> 
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</irk:ActivityLocation> 
<trk:Status> 
<trk:Type>l</trk:Type> 
<trk:Description>ORIGIN SCAN</trk:Description> 
<trk:Code>OR</trk:Code> 
</irk:Status> 
<trk:Date>20100505</trk:Date> 
<trk:Time>010000</trk:Time> 
</trk:Activity> 
<trk:PackageWeight> 
<trk:UnitOfMeasurement> 
<trk:Code>LBS</trk:Code> 
</trk:UnitOfMeasurement> 
<trk:Weight>0.00</trk:Weight> 
</irk:PackageWeight> 
<trk:ReferenceNumber> 
<trk:Code>01</trk:Code> 
<trk:Value>FLCAPA</trk:Value> 
</irk:ReferenceNumber> 
<trk:ReferenceNumber> 
<trk:Code>08</trk:Code> 
<trk:Value>T G5432</trk:Value> 
</irk:ReferenceNumber> 
</trk:Package> 
</irk:Shipment> 
</trk:TrackResponse> 
</soapenv:Body> 


</soapenv:Envelope> 
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Signature Tracking Request 


<soapenv:Envelope xmins:soapenv="http://schemas.xmlsoap.org/soap/envelope/” 
xmlns:v1="http:/Avww.ups.com/XMLSchema/XOLTWS/UPSS/1.0” 
xmins:v3="http:/Avww.ups.com/XMLSchema/XOLTWS/Track/v2.0” 
xmlns:v11="http/Avww.ups.com/XMLSchema/XOLTWS/Common/v1 .0”> 
<soapenv:Header> 
<v1:UPSSecurity> 
<v1:UsernameToken> 
<v1:Usernames> YourUserlD </v1 :Username> 
<v 1:Password>YourPassword</v1:Password> 
</v1:UsernameToken> 
<v1:ServiceAccessToken> 
<v 1:AccessLicenseNumber>YourLicenseNumber</v1 :AccessLicens eNumber> 
</v1:ServiceAccess Token> 
</v1:UPSSecurity> 
</soapenv:Header> 
<soapenv:Body> 
<v3:TrackRequest> 
<v11:Request> 
<v11:RequestOption>15</v11:RequestOption> 
<v11:TransactionReference> 
<v11:CustomerContext> Your Test Case Summary Description</v11:CustomerContext> 
</v11:TransactionReference> 
</v11:Request> 
<v3:Inquiry Number> YourTrackingNumber</v3:InquiryNumber> 
</v3:TrackRequest> 
</soapenv:Body> 
</soapenv:Envelope> 
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Signature Tracking Response 


<soapenv:Envelope xmlins:soapenv="http://schemas.xmlsoap.org/soap/envelope/”> 
<soapenv:Header/> 
<soapenv:Body> 
<trk:TrackResponse xmins:trk="http:/Avww.ups.com/XMLSchema/XOLTWS/Track/v2.0”> 


<common:Response 
xmins:common="http://www.ups.com/XMLSchema/XOLTWS/Common/v1.0”> 


<common:ResponseStatus> 
<common:Code>1</common:Code> 
<common:Description>Success</common:Description> 
</common:ResponseStatus> 
<common:TransactionReference> 
<common:CustomerContext>Signature track test</common:CustomerContext> 
</common:TransactionReference> 
</common:Response> 
<trk:Shipment> 
<trk: Inquiry Number> 
<trk:Code>01</trk:Code> 
<trk:Description>ShipmentidentificationNumber</trk:Description> 
<trk:Value>YourTrackingNumber</trk: Value> 
</trk :InquiryNumber> 
<trk:ShipperNumber>F001 00</trk: ShipperNumber> 
<trk:ShipmentWeight> 
<trk:UnitOfMeasurement> 
<trk:Code>LBS</trk :Code> 
</trk:UnitOfMeasurement> 
<trk:Weight>35.00</trk:Weight> 
</trk:ShipmentWeight> 
<trk:Service> 
<trk:Code>02</trk:Code> 
<trk:Description>UPS 2%° DAY AIR</trk:Description> 
</trk:Service> 
<trk:Package> 
<trk:TrackingNumber>Y ourTrackingNumber</trk :TrackingNumber> 
<trk:Activity> 
<trk:ActivityLocation> 
<trk:Address/> 
</trk:ActivityLocation> 
<trk:Status> 
<trk: Ty pe>X</trk :‘Type> 


<trk:Description>Delivered to UPS Access Point™ location and awaiting customer 
pickup. </trk:Description> 


<trk:Code>ZP</trk:Code> 
</trk:Status> 
<trk:Date>20130925</trk: Date> 
<trk: Time>1 72800</trk:Time> 
</trk:Activity> 
<trk:Activity> 
<trk:ActivityLocation> 
<trk:Address> 
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<trk:City>LONDON CENTRAL </trk:City> 
<trk:Country Code>GB</trk :CountryCode> 
</trk:Address> 
</trk:ActivityLocation> 
<trk:Status> 
<trk: Ty pe>X</trk:Type> 
<trk:Description>Delivered to UPS Access Point™ location and awaiting customer 
pickup. </trk:Description> 
<trk:Code>ZP</trk:Code> 
</trk:Status> 
<trk:Date>20130925</trk: Date> 
<trk:Time>1 72300</trk:Time> 
</trk:Activity> 
<trk:Activity> 
<trk:ActivityLocation> 
<trk:Address> 
<trk:City>MAYSVILLE</rk:City> 
<trk:StateProvinceCode>WV</irk:StateP rovinceCode> 
<trk:PostalCode>26833 9700</trk:PostalCode> 
<trk:Country Code>US</trk:CountryCode> 
</trk:Address> 
<trk:Code>MG</trk :Code> 
<trk:Description>LEFT WITH MAN</trk:Description> 
<trk:SignedForByName>Larry </trk:SignedForByName> 
</trk:ActivityLocation> 
<trk:Status> 
<trk:Type>D</trk:Type> 
<trk:Description>Delivered</trk:Description> 
<trk:Code>KB</trk: Code> 
</trk:Status> 
<trk:Date>200380313</rk:Date> 
<trk:Time>160000</trk:Time> 
<trk:Document> 
<trk:Type> 
<trk:Code>04</trk:Code> 
<trk:Description>POD Letter</trk:Description> 
</trk:Type> 
<trk:Content>Base64 Encoded PODLetter in html format</trk:Content> 
<trk:Format> 
<trk:Code>03</trk:Code> 
<trk:Description>HTML</trk:Description> 
</trk:Format> 
</trk:Document> 
</trk:Activity> 
<trk:PackageWeight> 
<trk:UnitOfMeasurement> 
<trk:Code>LBS</trk:Code> 
</trk:UnitOfMeasurement> 
<trk:Weight>35.00</trk:Weight> 
</trk:PackageWeight> 
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</trk:Package> 
</trk:Shipment> 
</trk:TrackResponse> 
</soapenv:Body> 
</soapenv:Envelope> 
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Chapter 6: Tracking API FAQs 


Scan Types Does a scan typedisplay when a_ UPS receives PSB scans at the shipmentlevel 
driverscansaPickup Summary | (when available), but we don’tdisplay the 
Barcode (PSB) in the Tracking information within our tracking systems. 
API? 
Scheduled Delivery Date |Doesthe Tracking API providea | Yes. ScheduledDeliveryDate container described 
(SDD) and Rescheduled Scheduled Delivery Date? within the Developer Guide. If the SDD changes 
Delivery Date (RSD) then a date is returned within the 
Rescheduled DeliveryDate container. 
Tracking Whatis the UPS Tracking API UPS Tracking API is an Internet-based 
and Signature Tracking API? application thatadds anew level of customer 


service throughout your company and 
functionality to your e-commerce Web site or 
enterprise application. With UPS Tracking API, 
your customers can track products they have 
purchased online more efficiently than ever 
before. 


UPS Tracking API: Provide up-to-the-minute 
shipment status — from origin to delivery —to your 
online customers. 


UPS Signature Tracking API: Obtain proof of 
delivery containing a digitized signature and 
delivery address. 


Tracking How much does the UPS UPS Tracking API is free to license. There are no 
Tracking API cost? hidden fees or charges, though you may require 
IT resources or 3 party developers depending on 
howcomplex your integration application is. 


Tracking Whatis the difference between Basically the Tracking and Signature Tracking 
Tracking API and Signature API is the same, with the exception for 
Tracking API? authorization to see full Delivery address, 


‘delivered to’name, and Signature image. 


Tracking Can | track freight shipments with | Yes. Consult the developers guide for the 
UPS Tracking API? appropriate XML request. 

Tracking Is Pre Pickup Visibility available | No. UPS Freight must bill the shipment before 
when tracking freightshipments — information is passed to UPS.com or QVM. UPS 
with UPS Tracking API has a rule that header information must be 

established before the shipmentcan be 
displayed. 


Header information is established atthe billing 
point, and that usually occurs the night ofthe 


shipment. 
Tracking Can | use Tracking informationin |UPS strongly discourage the use of Framed 
a Frame on my own site? information. See the UPS.Com Terms and 


Conditions accepted by all registered users. 


Tracking Why can’t | see my freight The Tracking API supports 2 reference numbers 
reference number in the XML per freight shipment. However, freight shipments 
response? may contain many more reference numbers, the 


API is limited to 2. 
Tracking Why is the Tracking Online Tools | Online Tools described many different APIs. UPS 


now called UPS Tracking API? Tracking API describes the Tracking API and 
registering for itis now simple and easier to use. 
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Tracking Could my Tracking API license UPS retains the rightto revoke an access key or 
be revoked? block access from any user that abuse the 
tracking system. 


Tracking Why am | notreceiving a Ifa shipment was created with the UPS Shipping 
response on my tracking number | API, UIS or UIFS, do notattempt to track it 
that | just created? Information immediately because it will not be available until 
unavailable. the UPS database has been populated with the 
manifest details, usually 5 to 10 minutes. 


Ifa shipper used ashipping system like 
WorldShip and fails to upload manifest details by 
completing EOD, UPS will nothave the manifest 
information, and Tracking will not be able to 
return a response until asubsequent event, 
example: origin scan. 


Transport Modes Whattransport modes are All modes of transport are available within the 
available within the Tracking Tracking API for; package, LTL Freight, Air 
API? Freight, and Ocean Freight. 

Basic tracking Does the Tracking API support | Yes, we display tracking info for BASIC on 
Basic service? UPS.com and in XOLT just like for any other 


package service. 

However, itis important to remember thatthe 
Delivery is made by the postoffice and a delivery 
scan may be delayed or not available at all. 
SDD/RDD is NOT displayed with Basic services 
tracking statuses. 

As for an In Transit status, the status is triggered 
by amovement scan, just like for our other 
package offerings. An origin, pickup, arrival, or 
departure scan will display In Transit status. 


Here is an example 1Z in production if you want 
to check: 1Z2W99W3PP20791577 


Reference Number If a customer processes 7 You can track a shipmentthroughreference 1 or 

Tracking packages in one shipment, will reference 2 only. When tracking a multiple-piece 
reference number tracking inthe | shipmentifyouuse the lead number it will show 
Tracking API playback allseven | youthe information for all the packages within 


packages or just the lead that shipment however, if youtrack with other 
package or any oneofthe than the lead number it will only show the tracking 
packages in some typeof order? information for that individual package. 

Reference number tracking Why do | see xxxxxxxxx1234 Based on therequest of some shippers, some 
instead of the tracking number tracking numbers in the reference number track 
when | do a reference number results may be masked. 
search 

Scan Info Is the “Billing Information Yes 


Received” scan thesame as the 
“Order Processed: Ready for 
UPS’ scan on the web? 


Scan Info Why isn’tthere a Scheduled Day | Sincethese are packages that can be injected 
of Delivery (SDD) returned with —_ into the UPS Operations from any channel UPS 
the Billing Information Received _ waits until we are certain we have taken 
scan? possession ofthe package prior to including an 

SDD. 
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Scan Info | see the Tracking API returning a UPS Internal Activity scan is a generic description 


scan called “UPS Internal 
Activity”. Whatis this and why 
don't! see this when | track a 
package on the web at 


UPS.com? 

Delivery Receipts Can | obtain UPGF delivery 
receipts? 

POD How long can I store the POD? 

MYUPSID for freight How can | linkthe MYUPSID to 
freight? 


for one of several internal operations scans which 
are filtered by the web tracking application at 
UPS.com. These scans are not used 

externally. You may consider dropping these 
records in your process. 


Yes, thereis linkage at UPS Freight whereit is 
determined if the User ID is associated with either 
the shipper, the consignee or the third party, that 
ID is allowed to see specific documenttypes and 
to see additional information contained in the 
tracking response. 


Each shipper, consignee and third party customer 
have an accountnumber. If any ofthose 
accounts match any of the accounts associated 
with the User ID, then they have additional 
privileges. See your account executive for 
additional details. 


UPS Technology Agreement allows youto storea 
POD letter (which may or may notcontain digital 
signature) fora maximum of 18 months. 


You need to use UPS Internet Freight Shipping 
(UIFS) on UPS.com, process aGround Freight 
(LTL) shipment, when the rate responsedisplays, 
there will be a blue link on the bottom left of the 
pagethat says “Enroll Now’. Click on thelink, 
complete the registration page and submit. 
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High Frequency tracking 
guidelines 


General 


Whatare guidelines for high 
frequency tracking? 


Whatis Pre-Authorized Returns? 


* Ensure tracking requests are valid. If your 
request returns an error message such as 
"tracking number notfound", "no information 
available", or "invalid tracking number", you 
should research the cause of the error before 
continuing to track the same number. 


* When theresults ofa tracking requestindicatea 
“delivered” status do notcontinue to track the 
package. 


* Track packages during “off hours” whenever 
possible, “offhours” are from 5:00 pm till 8:00 am 
East Coasttime. 


* Use your UPS service level (Early, Next Day Air, 
etc.) to determine the best time of day to track 
and receive up to the minute tracking information. 


* Evenly distribute your information requests over 
the remaining 19 hour window. 


* If daily/weekly tracking requests exceed daily 
shipping volume by a large margin, UPS will 
reserve the rightto suspend tracking for that 
accountuntil the situation is rectified. lfa 
resolution cannotbe found and implemented, 
tracking for that account may be terminated. 


* If you are tracking with an automated tracking 
robot make sure you check your system at least 
oncea week to insureit’s operating at peak 
performance. MostHFT cases are due to 
automated tracking systems becoming corrupt 
and falling into atracking loop. 


* Refrain from tracking the same numbers 
continually throughout the day. Unique tracking 
numbers should be tracked no more than once 
per hourora maximum of 24 times in a single 
day. 


* Avoid automatic access between 10:00 am to 
3:00 pm EST. However, you may track critical 
packages during this time. 


A shipper has the ability to authorize a receiver to 
printa Return Service Label to make retail 
merchandise returns easier. A URL is included in 
the Response XML for eligible packages 
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Storage of electronic How long is datastored for 

image Signature Tracking signature 
image? 

Storage of electronic Is there a watermark behind the 

image signature image returned by the 


UPS Signature Tracking API? 


Transmissionofelectronic Can the POD Letter generated 


image through aPOD image be 
emailed? 
Tracking How do |! add shipper accounts 


for authorization to Signature 
Tracking API? 


120 days. 


Yes. It is part of the signature image returned by 
the UPS Signature Tracking API and cannot be 
modified in any way, transferred etcetera. 


Electronic Signature Images and POD Letters 


The information youreceive through the API may 
include electronic signature images. 


Electronic Signature Images, other than as part of 
a POD Letter, may notbe stored, distributed to 
any third party, copied, or modified. 


Each POD Letter generated or developed as the 
result of using or access to the UPS OnLine Tools 
Tracking Tool may be stored in electronic format 
until eighteen (18) months after the delivery ofthe 
shipment referenced in the POD Letter. 


Your application may notdistributea POD Letter 
electronically to third parties, other than asa 
facsimile transmission. 


No. Only faxed or mailed. It can be stored 
electronically for 18 months but cannotbe 
emailed. 


To add shipper account for Signature tracking the 
user can access myUPS on UPS.Com by logging 
in with the user ID and password associated with 
the access key, and adding the accountto the 
accountsummary. A recentinvoicewill be 
needed to provide the latest invoice date, amount, 
and control number (if applicable) 
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Error Codes (WS) 


When the UPS systemis unable to respond to arequest, be it froma malformed request, an illegal or invalid value, or 
other issues, the API generates an error response. For examples and additional informationon error responses, refer 
to Chapter 3: Error Responses, inthe Introduction to the UPS Developer Kit guide. 
Successful responses may or may notinclude alerts. 

o Without alerts — Indicates the request has been processed as anticipated. 

o With alerts — Indicates the request has been processed with potentially unanticipated results. The alert 

contains information in the response that should be passed to the end user. 

The severity ofan error may be transientor hard. 


o Transient error —Indicates an error that is temporary in nature. Such errors may be caused by response 
timeouts due to high server loads or scheduled maintenance in progress. The request may be issued 
successfully ata later time. 


o Hard error -— Indicates the requesthas a problem that the system is notable to resolve. These errors are 
critical and prevent requests from processing. 


i 


Do not resubmit requests with Hard Errors until the problems causing the error have been 
resolved. 


i) 


Common Error Codes 


The following error codes can apply to all Webservice and other APIs. 


10001 Hard The requestis notwell formed. 

10002 Hard The requestis well formed but the requestis not valid. 

10003 Hard The requestis either empty or null. 

10006 Hard Although the documentis well formed and valid, the element content contains values 


which do notconformto the rules and constraints contained in this specification. 
10013 Hard The messageis too large to be processed by the Application. 
10429 Transient Too many requests 


20001 Transient General process failure. 


20002 Hard The specified servicename, {0}, and version number, {1}, combination is invalid. 
20003 Hard Please check the server environment for the proper J2EE ws apis. 
20006 Hard Invalid requestaction. 

20007 Hard Missing Required field, {0}. 

20008 Hard The field, {0}, contains invalid data, {1}. 

20012 Hard The Client Information exceeds its Maximum Limit of {0}. 

250000 = Hard No XML declaration in the XML document. 

250001 ~=Hard Invalid Access License for the tool. Please re-license. 

250002 ~=Hard Invalid Userld/Passwo rd. 

250003 Hard Invalid Access License number. 

250004 ~=Hard Incorrect Userld or Password. 

250005 = Hard No Access and Authentication Credentials provided. 
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250006 
250007 
250009 
250019 
250050 


Hard 
Hard 
Hard 
Hard 


Transient 


The maximum number ofuser access attempts was exceeded. 
The Userld is currently locked out; please try again in 30 minutes. 
License Number notfound in the UPS database. 

Invalid Field value. 


License system not available. 


Tracking Error Codes 


20011 


150000 
150020 
150021 
150022 
150023 
150024 
150025 
150026 
150027 
150028 
150029 
150030 
150040 
150099 


151018 
151019 
151036 
151038 
151040 
151044 
151045 


151050 


Hard 


Transient 
Hard 
Hard 
Hard 
Hard 
Hard 
Hard 
Hard 
Hard 
Hard 
Hard 
Hard 
Hard 


Transient 


Hard 
Hard 
Hard 
Hard 
Hard 
Hard 
Hard 


Hard 


The Integration indicatoris no longer supported 


Tracking service unavailable 

Invalid pickup date range 

Invalid shipment identification number 

Invalid tracking number 

Invalid reference number value length 

Invalid destination postal codelength 

Invalid destination country code length 

Invalid begin date length 

Invalid end date length 

Invalid shipper number length 

Duplicate Tracking Numbers found in Package Detail 
Invalid Request/ RequestOption 

Invalid datafound or the combination of data elements is invalid 


Delivery Change Request System Unavailable 


Invalid tracking number 

No activity records found for tracking number 

Either tracking number or reference number required 
Shipmentnumber required with reference number 
Both tracking number and reference number invalid 
No tracking information available 

No information found 


Too many records to display 
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151051 
151062 
151068 
151085 
151086 


151091 


151602 
152012 
152100 
152110 
152315 
154010 
154030 
154040 
154050 
154070 
154082 
154083 


150084 
150085 


154086 


155001 
155002 
155003 
155005 
155006 


9150001 
9150002 


9150003 


Hard 
Hard 
Hard 
Hard 


Hard 


Hard 


Hard 
Hard 
Hard 
Hard 
Hard 
Hard 
Hard 
Hard 
Hard 
Hard 
Hard 


HARD 


Hard 
Hard 


Hard 


Transient 
Hard 
Hard 
Hard 
Hard 


Hard 
Hard 


Hard 


Some Records are notreturned 
No tracking information available 
Invalid Shipper Number 

Multiple shipper numbers found 


Maximum candidate exceeded for Reference number search. Use the tracking number 
search 


Multiple reference numbers found, it may be possible to narrow the search with 
additional data. 


Destination Country Code must be entered 

Number of records selected exceeds limit of 175 

Enter shipper number -—additional shippers used the reference 
No information found for reference number 

Multiple reference numbers found, it is not possible to qualify further. 
Invalid inquiry number 

No information for this tracking number 

Invalid tracking type 

Non-unique BCD number -—Candidate List returned 

Signature Tracking Options not available without successful login 
The supplied Candidate Bookmark fails validation 


Specific Tracking data could notbe found. It may be possible to narrow the search with 
additional data. 


Invalid origin postal code length 
Invalid origin country code length 


Missing origin country code when origin postal code is supplied 


Mail Innovations Tracking Service Unavailable. 
Mail Innovations Tracking Information not found. 
Invalid request option for Mail Innovations. 
Invalid country code for Mail Innovations. 


Invalid postal code for Mail Innovations. 


Invalid access license number for tracking request option 


Invalid or missing inquiry number -—Tracking Number, Shipmentldentification Number, or 
ReferenceNumber 


Invalid Candidate Bookmark 
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9150004 Hard 
9150006 Hard 
9150007 Hard 
9150008 Hard 
9150009 Hard 
9154099 Hard 
9151000 Hard 
Alert Codes 


Shipment Type should be specified when tracking by Reference Number 
CountryCode should be specified when ShipperAccountinfo container is present. 
Missing Recipient Email Address 

Missing Failure Email Address 

Missing Language information. 


Either ExceptionNotification Indicator or Delivery NotificationIndicator has to be supplied 
with Quantum View Notification request. 


Invalid Tracking Request Document 


ee ed 


154080 | Could notverify Signature rights 


154081 


Your search returned multiple Shipments. Please select from the provided results. 


155004 | Max size ofthe candidate listis exceeded. 
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01 --Signature Required 

02 -—Adult Signature Required 

03 --Import Control 

04 -—-Commercial Invoice Removal 
05 --UPS Carbon Neutral 


06 --USPS PIC Number Of Flexible Return Shipment (The value tag is populated) 


June 23, 2021 


07 --Product Type (This may have additional attributes populated for product type code and description) 


08 --Location Assured 

09 — Exchange Based 

10 — Packand Collect 

030 — Hazardous Material Dangerous Goods 
035 — Saturday Pickup 

036 — Saturday Delivery 

039 — Declared Value Insurance 

043 — Customized Delivery Confirm. 

058 -—Hold for Pickup 

209 — Dry Ice 

229 — Carbon Neutral Shipment 

232 — UPS Returns Exchange (Forward MVMT) 
233 — UPS Ret Pack and Collect 

234 — UPS Returns Exchange Print Label 
254 --Lift Gate Service for Delivery 

255 --Lift Gate Service for Pickup 

256 -—Drop Off At Facility 

259 -—Directto Retail 

261 -—-Deliver to Addressee only 

262 -—Deliver to Retail COD 

263 --Retail to Retail Shipment 

426 --Direct Delivery Only 

427 --Infectious Substance Category A 
428 --Package Release Code 
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Country/Territory Codes 


Tracking API Supported Countries/Territories 


UPS country/territory code abbreviations generally follow the recommendations of the International Standards 
Organization (ISO), which publishes alist of country or territory abbreviations in ISO Standard 3166. 


The following table lists the country or territory codes defined by ISO at the time ofthis publication. The latest 
information is available fromthe ISO web site: http ://www.iso.org/. 


= NOTE: Notall UPS services are available in every country/territory. Refer to the UPS Rate and Service Guide at 
UPS.com for more information on UPS services. 


Country/Territory Name Country/Territory Code| Supported Supported 
Forward Origin Return Origin 
AF 


Afghanistan 


Aland Islands AX 

Albania AL Yes 
Algeria DZ 

American Samoa AS 

Andorra AD Yes 
Angola AO 

Anguilla Al Yes 
Antarctica AQ 

Antigua and Barbados AG Yes 
Argentina AR Yes Yes 
Armenia AM 

Aruba AW 

Australia AU Yes Yes 
Austria AT Yes Yes 
Azerbaijan AZ 

Bahamas BS Yes 

Bahrain BH Yes 
Bangladesh BD 

Barbados BB 

Belarus BY 

Belgium BE Yes Yes 
Belize BZ 

Benin BJ 

Bermuda BM Yes Yes 
Bhutan BT 
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Country/Territory Name Country/Territory Code| Supported Supported 
Forward Origin Return Origin 
BO Yes 


Bolivia 

Bosniaand Herzegovina BA 

Botswana BW 

Bouvet Island BV 

Brazil BR Yes Yes 
British Indian Ocean Territory lO 

Brunei Darussalam BN 

Bulgaria BG Yes 
Burkina Faso BF 

Burundi BI 

Cambodia KH 

Cameroon CM 

Canada CA Yes Yes 
Cape Verde CV 

Cayman Islands KY Yes 

Central African Republic CF 

Chad TD 

Chile CL Yes Yes 
China Mainland CN Yes Yes 
Christmas Island CX 

Cocos (Keeling) Islands CC 

Colombia co Yes Yes 
Comoros KM 

Congo CG 

Congo, The Democratic CD 

Republic of 

Cook Islands CK 

Costa Rica CR Yes Yes 
Céte Divoire Cl 

Croatia HR Yes 
Cuba CU 

Cyprus CY Yes 
Czech Republic CZ Yes Yes 
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Country/Territory Name Country/Te 


Denmark 

Djibouti 

Dominica 
Dominican Republic 
Ecuador 

Egypt 

El Salvador 
Equatorial Guinea 
Eritrea 

Estonia 

Ethiopia 

Falkland Islands (Malvinas) 
Faroe Islands 

Fiji 

Finland 

France 

French Guiana 
French Polynesia 
French Southern Territories 
Gabon 

Gambia 

Georgia 
Germany 

Ghana 

Gibraltar 

Greece 
Greenland 
Grenada 
Guadeloupe 
Guam 

Guatemala 
Guernsey 


Guinea 


June 23, 2021 


rritory Code} Supported Supported 
Forward Origin Return Origin 
DK Yes Yes 


DJ 
DM 
DO 
EC 
EG 
SV 
GQ 
ER 
EE 
ET 
FK 
FO 
FJ 
FI 
FR 
GF 
PF 
TF 
GA 
GM 
GE 
DE 
GH 
GI 
GR 
GL 
GD 
GP 
GU 
GT 
GG 
GN 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 
Yes 
Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 
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Country/Territory Name Country/T 


Guinea-Bissau 
Guyana 
Haiti 


Heard Island and 
McDonald Islands 


Holy See (Vatican City 
State) 


Honduras 

Hong Kong SAR, China 
Hungary 

Iceland 

India 

Indonesia 

Iran, Islamic Republic of 
Iraq 

Ireland 

Isle of Man 

Israel 

Italy 

Jamaica 

Japan 

Jersey 

Jordan 

Kazakhstan 

Kenya 


Kiribati 


Korea, Democratic People’s 


Republic of 

Korea, Republic of 
Kuwait 

Kyrgyzstan 


Lao Peoples Democratic 
Republic 


Latvia 


Lebanon 


June 23, 2021 


erritory Code} Supported Supported 
Forward Origin Return Origin 
GW 


GY 
HT 


HM 


VA 


HN 
HK 


LV 


LB 


Yes 
Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 
Yes 
Yes 
Yes 
Yes 


Yes 


Yes 


Yes 
Yes 
Yes 
Yes 


Yes 


Yes 


Yes 


Yes 


Yes 
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Country/Territory Name Country/Territory Code| Supported Supported 
Forward Origin Return Origin 
LS 


Lesotho 

Liberia LR 

Libyan Arab Jamahiriya LY 

Liechtenstein LI Yes 
Lithuania LT Yes 
Luxembourg LU Yes 
Macau (Macao) SAR, China MO Yes Yes 
Macedonia, The Former MK 


Yugoslav Republic of 


Madagascar MG 

Malawi MW 

Malaysia MY Yes Yes 
Maldives MV 

Mali ML 

Malta MT Yes 
Marshall Islands MH 

Martinique MQ Yes 
Mauritania MR 

Mauritius MU 

Mayotte YT 

Mexico MX Yes Yes 
Micronesia, Federated FM 

States of 

Moldova, Republic of MD 

Monaco MC Yes 
Mongolia MN 

Montenegro ME Yes 
Montserrat MS Yes 
Morocco MA 

Mozambique MZ 

Myanmar MM 

Namibia NA 

Nauru NR 

Nepal NP 
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Country/Territory Name Country/Te 


Netherlands 
Netherlands Antilles 
New Caledonia 
New Zealand 
Nicaragua 

Niger 

Nigeria 

Nigeria 

Niue 

Norfolk Island 
Northern Mariana Islands 
Norway 

Oman 

Pakistan 

Palau 


Palestinian Territory, 
Occupied 


Panama 

Papua New Guinea 
Paraguay 

Peru 

Philippines 

Pitcairn 

Poland 

Portugal 

Puerto Rico 

Qatar 

Réunion 

Romania 

Russian Federation 
Rwanda 

Saint Helena 


Saint Kitts and Nevis 
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rritory Code} Supported Supported 
Forward Origin Return Origin 
NL Yes Yes 


AN 
NC 
NZ 
NI 
NE 
NG 
NG 
NU 
NF 
MP 
NO 
OM 
PK 
PW 


PS 


PA 
PG 
PY 
PE 
PH 
PN 
PL 
PT 
PR 
QA 
RE 
RO 
RU 
RW 
SH 


KN 


Yes 


Yes 


Yes 


Yes 


Yes 
Yes 


Yes 


Yes 
Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 
Yes 
Yes 


Yes 


Yes 


Yes 
Yes 


Yes 


Yes 
Yes 
Yes 


Yes 


Yes 


Yes 


Yes 


© 2021 United Parcel Service of America, Inc. All Rights Reserved. Confidential and Proprietary 


66 


UPS Tracking Web Service Developer Guide 


Country/Territory Name Country/Te 


Saint Lucia 
Saint Pierre and Miquelon 


Saint Vincent and The 
Grenadines 


Samoa 

San Marino 

Sao Tome and Principe 
Saudi Arabia 
Senegal 

Serbia 
Seychelles 
Sierra Leone 
Singapore 
Slovakia 
Slovenia 
Solomon Islands 
Somalia 

South Africa 


South Georgia and 
The South Sandwich Islands 


Spain 

Sri Lanka 

Sudan 

Suriname 

Svalbard and Jan Mayen 
Swaziland 

Sweden 

Switzerland 

Syrian Arab Republic 
Taiwan, China 
Tajikistan 

Tanzania, United Republic of 
Thailand 


Timor-Leste 
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rritory Code} Supported Supported 
Forward Origin Return Origin 
LC Yes 


PM 


VC 


WS 
SM 
ST 
SA 
SN 
RS 
SC 
SL 
SG 
SK 
S| 
SB 
SO 
ZA 
GS 


ES 
LK 
SD 
SR 
SJ 
SZ 
SE 
CH 
SY 
TW 
TJ 
TZ 
TH 
TL 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 
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Country/Territory Name Country/T 


Togo 

Tokelau 

Tonga 

Trinidad and Tobago 
Tunisia 

Turkey 

Turkmenistan 

Turks and Caicos Islands 
Tuvalu 

Uganda 

Ukraine 

United Arab Emirates 
United Kingdom 
United States 


United States Minor 
Outlying Islands 


Uruguay 
Uzbekistan 
Vanuatu 

Venezuela 

Viet Nam 

Virgin Islands, British 
Virgin Islands, U.S. 
Wallis and Futuna 
Western Sahara 
Yemen 

Zambia 


Zimbabwe 
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erritory Code} Supported Supported 
Forward Origin Return Origin 
TG 


TK 
TO 
TT 
TN 
TR 
T™ 
TC 
TV 
UG 
UA 
AE 
GB 
US 
UM 


UY 
UZ 
VU 
VE 
VN 
VG 
Vi 
WF 
EH 
YE 
ZM 
ZW 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 
Yes 
Yes 


Yes 


Yes 


Yes 


Yes 
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UPS currency code abbreviations generally follow the recommendations ofthe International Standards Organization 


(ISO), which publishes alist of currency abbreviations in ISO Standard 4217. The following table lists the currency 
codes defined by ISO at the time of this publication. Thelatest information is available fromthe ISO web site: 


http :/www.iso.org/. 


Countries/Territories may sometimes change their official currency. UPS does require time after the introduction ofa 
new currency before it can fully support that currency. In addition, UPS may continue to supportthe older currency for 
an interim period in order to provide backwards compatibility. 


UPS may also require the use ofcurrencies other than the official currency for somecountries/Territories. 


Afghanistan 
Albania 
Algeria 
American Samoa 
Andorra 
Angola 
Anguilla 
Antigua And Barbuda 
Argentina 
Armenia 
Aruba 
Australia 
Austria 
Azerbaijan 
Bahamas 
Bahrain 
Bangladesh 
Barbados 
Belarus 
Belgium 
Belize 

Benin 
Bermuda 
Bhutan 
Bhutan 
Bolivia 


Bolivia 
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Afghani 

Lek 

Algerian Dinar 

US Dollar 

Euro 

Kwanza 

East Caribbean Dollar 
East Caribbean Dollar 
Argentine Peso 
Armenian Dram 
Aruban Guilder 
Australian Dollar 
Euro 

Azerbaijanian Manat 
Bahamian Dollar 
Bahraini Dinar 

Taka 

Barbados Dollar 
Belarussian Ruble 
Euro 

Belize Dollar 

CFA Franc BCEAO 
Bermudian Dollar 
Indian Rupee 
Ngultrum 

Boliviano 


Mvdol 


ALL 
DZD 
USD 
EUR 
AOA 
XCD 
XCD 
ARS 
AMD 
AWG 
AUD 
EUR 
AZN 
BSD 
BHD 
BDT 
BBD 
BYR 
EUR 
BZD 
XOF 
BMD 
INR 
BTN 
BOB 
BOV 
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Bosnia and Herzegovina 


Botswana 
Bouvet Island 


Brazil 


British Indian Ocean Territory 


Brunei Darussalam 
Bulgaria 

Burkina Faso 

Burundi 

Cambodia 

Cameroon 

Canada 

Cape Verde 

Cayman Islands 
Central African Republic 
Chad 

Chile 

Chile 

China Mainland 
Christmas Island 

Cocos (Keeling) Islands 
Colombia 

Colombia 

Comoros 


Congo 


Congo, The Democratic Republic of 


Cook Islands 
Costa Rica 
Céte Divoire 
Croatia 

Cuba 

Cyprus 


Czech Republic 
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Convertible Marks 
Pula 

Norwegian Krone 
Brazilian Real 

US Dollar 

Brunei Dollar 
Bulgarian Lev 

CFA Franc BCEAO 
Burundi Franc 

Riel 

US Dollar 
Canadian Dollar 
Cape Verde Escudo 
Cayman Islands Dollar 
CFA Franc BEAC 
CFA Franc BEAC 
Chilean Peso 
Unidades de formento 
Yuan Renminbi 
Australian Dollar 
Australian Dollar 
Colombian Peso 
Unidad de Valor Real 
Comoro Franc 

CFA Franc BEAC 
Franc Congolais 
New Zealand Dollar 
Costa Rican Colon 
CFA Franc BCEAO 
Croatian Kuna 
Cuban Peso 

Euro 


Czech Koruna 
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BWP 
NOK 
BRL 
USD 
BND 
BGN 
XOF 
BIF 
KHR 
USD 
CAD 
CVE 
KYD 
XAF 
XAF 
CLP 
CLF 
RMB 
AUD 
AUD 
COP 
COU 
KMF 
XAF 
CDF 
NZD 
CRC 
XOF 
HRK 
CUP 
EUR 


CZK 
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Denmark 

Djibouti 

Dominica 
Dominican Republic 
Ecuador 

Egypt 

El Salvador 

El Salvador 
Equatorial Guinea 
Eritrea 

Estonia 

Ethiopia 

Falkland Islands (Malvinas) 
Faroe Islands 

Fiji 

Finland 

France 

French Guiana 
French Polynesia 
French Southern Territories 
Gabon 

Gambia 

Georgia 
Germany 

Ghana 

Gibraltar 

Greece 
Greenland 
Grenada 
Guadeloupe 
Guam 

Guatemala 


Guernsey 
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Danish Krone 


Djibouti Franc 


East Caribbean Dollar 


Dominican Peso 


US Dollar 


Egyptian Pound 


El Salvador Colon 


US Dollar 


CFA Franc BEAC 


Nakfa 
Euro 


Ethiopian Birr 


Falkland Islands Pound 


Danish Krone 
Fiji Dollar 
Euro 

Euro 

Euro 

CFP Franc 


Euro 


CFA Franc BEAC 


Dalasi 
Lari 
Euro 


Cedi 


Gibraltar Pound 


Euro 


Danish Krone 


East Caribbean Dollar 


Euro 
US Dollar 


Quetzal 


Pound Sterling 
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DJF 
XCD 
DOP 
USD 
EGP 
SVC 
USD 
XAF 
ERN 
EUR 
ETB 
FKP 
DKK 
FJD 
EUR 
EUR 
EUR 
XPF 
EUR 
XAF 
GMD 
GEL 
EUR 
GHS 
GIP 
EUR 
DKK 
XCD 
EUR 
USD 
GTQ 
GBP 
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Guinea Guinea Franc 

Guinea-Bissau Guinea-Bissau Peso GWP 
Guinea-Bissau CFA Franc BCEAO XOF 
Guyana Guyana Dollar GYD 
Haiti Gourde HTG 
Haiti US Dollar USD 
Heard Island ond McDonald Islands Australian Dollar AUD 
Holy See (Vatican City State) Euro EUR 
Honduras Lempira HNL 
Hong Kong SAR, China Hong Kong Dollar HKD 
Hungary Forint HUF 
Iceland Iceland Krona ISK 

India Indian Rupee INR 

Indonesia Rupiah IDR 

Iran (Islamic Republic of) Iranian Rial IRR 

Iraq Iraqi Dinar lIQD 
Ireland Euro EUR 
Israel New Israeli Sheqel ILS 

Italy Euro EUR 
Jamaica Jamaican Dollar JMD 
Japan Yen JPY 
Jersey Pound Sterling GBP 
Jordan Jordanian Dinar JOD 
Kazakhstan Tenge KZT 
Kenya Kenyan Shilling KES 
Kiribati Australian Dollar AUD 
Korea, Democratic Peoples Republic of North Korean Won KPW 
Korea, Republic of Won KRW 
Kuwait Kuwaiti Dinar KWD 
Kyrgyzstan Som KGS 
Lao Peoples Democratic Republic Kip LAK 
Latvia Euro EUR 
Lebanon Lebanese Pound LBP 
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ncy Code 
ZAR 


Lesotho 

Lesotho 

Liberia 

Libyan Arab Jamahiriya 
Liechtenstein 

Lithuania 

Luxembourg 

Macau (Macao) SAR, China 


Macedonia, The Former Yugoslav Republic 
of 


Madagascar 
Malawi 

Malaysia 
Maldives 

Mali 

Malta 

Marshall Islands 
Martinique 
Mauritania 
Mauritius 
Mayotte 

Mexico 

Mexico 
Micronesia (Federated States of) 
Moldova, Republic of 
Monaco 
Mongolia 
Montenegro 
Montserrat 
Morocco 
Mozambique 
Myanmar 
Namibia 


Namibia 
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Rand 

Loti 

Liberian Dollar 
Libyan Dinar 
Swiss Franc 
Euro 

Euro 

Pataca 


Denar 


Malagascy Ariary 
Kwacha 

Malaysian Ringgit 
Rufiyaa 

CFA Franc BCEAO 
Euro 

US Dollar 

Euro 

Ouguiya 

Mauritius Rupee 
Euro 

Mexican Peso 
Mexican Unidad de Inversion (UID) 
US Dollar 
Moldovan Leu 
Euro 

Tugrik 

Euro 

East Caribbean Dollar 
Moroccan Dirham 
Metical 

Kyat 

Rand 


Namibian Dollar 
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LSL 

LRD 
LYD 

CHF 
EUR 
EUR 
MOP 


MKD 


MGA 
MWK 
MYR 
MVR 
XOF 
EUR 
USD 
EUR 
MRO 
MUR 
EUR 
MXN 
MXV 
USD 
MDL 
EUR 
MNT 
EUR 
XCD 
MAD 
MZN 
MMK 
ZAR 
NAD 
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Nauru 
Nepal 


Netherlands 


Netherlands Antilles 


New Caledonia 
New Zealand 
Nicaragua 
Niger 

Nigeria 

Niue 


Norfolk Island 


Northern Mariana Islands 


Norway 

Oman 

Pakistan 

Palau 

Panama 

Panama 

Papua New Guinea 
Paraguay 

Peru 

Philippines 

Pitcairn 

Poland 

Portugal 

Puerto Rico 

Qatar 

Réunion 

Romania 

Russian Federation 
Rwanda 


Saint Helena 


Saint Kitts and Nevis 
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Australian Dollar 
Nepalese Rupee 


Euro 


Netherlands Antillian Guilder 


CFP Franc 

New Zealand Dollar 
Cordoba Oro 

CFA Franc BCEAO 
Naira 

New Zealand Dollar 
Australian Dollar 
US Dollar 
Norwegian Krone 
Rial Omani 
Pakistan Rupee 

US Dollar 

Balboa 

US Dollar 

Kina 

Guarani 

Nuevo Sol 
Philippine Peso 
New Zealand Dollar 
Zloty 

Euro 

US Dollar 

Qatari Rial 

Euro 

New Leu 

Russian Ruble 
Rwanda Franc 


Saint Helena Pound 


East Caribbean Dollar 
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NPR 
EUR 
ANG 
XPF 
NZD 
NIO 
XOF 
NGN 
NZD 
AUD 
USD 
NOK 
OMR 
PKR 
USD 
PAB 
USD 
PGK 
PYG 
PEN 
PHP 
NZD 
PLN 
EUR 
USD 
QAR 
EUR 
RON 
RUB 
RWF 
SHP 


XCD 
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Saint Lucia 


Saint Pierre and Miquelon 


Saint Vincent and The Grenadines 


Samoa 

San Marino 

Sao Tome and Principe 
Saudi Arabia 
Senegal 

Serbia 

Seychelles 

Sierra Leone 
Singapore 

Slovakia 

Slovenia 

Solomon Islands 
Somalia 

South Africa 

Spain 

Sri Lanka 

Sudan 

Suriname 

Svalbard and Jan Mayen 
Swaziland 

Sweden 

Switzerland 
Switzerland 
Switzerland 

Syrian Arab Republic 
Taiwan, China 


Tajikistan 


Tanzania, United Republic of 


Thailand 


Timor-Leste 
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East Caribbean Dollar 
Euro 

East Caribbean Dollar 
Tala 

Euro 

Dobra 

Saudi Riyal 

CFA Franc BCEAO 
Serbian Dinar 
Seychelles Rupee 
Leone 

Singapore Dollar 
Euro 

Euro 

Solomon Islands Dollar 
Somali Shilling 
Rand 

Euro 

Sri Lanka Rupee 
Sudanese Dinar 
Surinam Dollar 
Norwegian Krone 
Lilangeni 

Swedish Krona 
Swiss Franc 

WIR Franc 

WIR Euro 

Syrian Pound 

New Taiwan Dollar 
Somoni 

Tanzanian Shilling 
Baht 


US Dollar 
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EUR 
XCD 
WST 
EUR 
STD 
SAR 
XOF 
RSD 
SCR 
SLL 
SGD 
EUR 
EUR 
SBD 
SOS 
ZAR 
EUR 
LKR 
SDD 
SRD 
NOK 
SZL 
SEK 
CHF 
CHW 
CHE 
SYP 
TWD 
TJS 
TZS 
THB 


USD 
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Togo 

Tokelau 

Tonga 

Trinidad And Tobago 
Tunisia 

Turkey 

Turkmenistan 

Turks And Caicos Islands 
Tuvalu 

Uganda 

Ukraine 

United Arab Emirates 
United Kingdom 
United States 

United States Minor Outlying Islands 
Uruguay 

Uruguay 

Uzbekistan 

Vanuatu 

Venezuela 

Viet Nam 

Virgin Islands (British) 
Virgin Islands (US) 
Wallis And Futuna 
Western Sahara 
Yemen 

Zambia 


Zimbabwe 
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CFA Franc BCEAO 
New Zealand Dollar 
Paanga 

Trinidad and Tobago Dollar 
Tunisian Dinar 

New Turkish Lira 
Manat 

US Dollar 
Australian Dollar 
Uganda Shilling 
Hryvnia 

UAE Dirham 

Pound Sterling 

US Dollar 

US Dollar 

Peso Uruguayo 
Uruguay Peso en Unidades Indexadas 
Uzbekistan Sum 
Vatu 

Bolivar 

Dong 

US Dollar 

US Dollar 

CFP Franc 
Moroccan Dirham 
Yemeni Rial 
Kwacha 


Zimbabwe Dollar 
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NZD 
TOP 
TTD 
TND 
TRY 
TMM 
USD 
AUD 
UGX 
UAH 
AED 
GBP 
USD 
USD 
UYU 
UY! 
UZS 
VUV 
VEB 
VND 
USD 
USD 
XPF 
MAD 
YER 
ZMK 


ZWD 
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Current Status Codes 


000 Status Not Available 

003 Order Processed: Ready for UPS 
005 In Transit 

006 On Vehicle for Delivery 

007 Shipment Information Voided 
010 In Transit: On Time 

011 Delivered 

012 Clearance in Progress 

013 Exception 

014 Clearance Completed 

016 Held in Warehouse 


017 Held for Customer Pickup 


018 Delivery Change Requested: Hold for Pickup 


019 Held for Future Delivery 

020 Held for Future Delivery Requested 
021 On Vehicle for Delivery Today 

022 First Attempt Made 

023 Second Attempt Made 


024 Final Attempt Made 


025 Transferred to Local Post Office for Delivery 


026 Delivered by Local Post Office 


027 Delivery Address Change Requested 


028 Delivery Address Changed 

029 Exception: Action Required 

030 Local Post Office Exception 

032 Adverse Weather May Cause Delay 
033 Return to Sender Requested 

034 Returned to Sender 

035 Returning to Sender 


036 Returning to Sender: In Transit 


037 Returning to Sender: On Vehicle for Delivery 


038 Picked Up 
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039 
040 
041 
042 
043 
044 
045 
046 
047 
048 
049 
050 
051 
052 
053 
054 
055 
056 
057 
058 
059 
060 
061 
062 
063 
064 
065 
066 
067 
068 
069 
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In Transit by Post Office 


Delivered to UPS Access Point Awaiting Customer Pickup 


Service Upgrade Requested 

Service Upgraded 

Voided Pickup 

In Transit to UPS 

Order Processed: In Transitto UPS 

Delay 

Delay 

Delay 

Delay: Action Required 

Address Information Required 

Delay: Emergency Situation or Severe Weather 
Delay: Severe Weather 

Delay: Severe Weather, Recovery in Progress 
Delivery Change Requested 

Rescheduled Delivery 

Service Upgrade Requested 

In Transitto a UPS Access Point 

Clearance Information Required 

Damage Reported 

Delivery Attempted 

Delivery Attempted: Adult Signature Required 
Delivery Attempted: Funds Required 

Delivery Change Completed 

Delivery Refused 

Pickup Attempted 

Post Office Delivery Attempted 

Returned to Sender by Post Office 

Sent to Lostand Found 


Package Not Claimed 
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Package Service Codes 


01 
02 
03 
04 
05 
06 
07 
08 


-—Signature Required 

--Adult Signature Required 

--Import Control 

--Commercial Invoice Removal 

--UPS Carbon Neutral 

--USPS PIC Number Of Flexible Return Shipment (The value tag is populated) 

-—Product Type (This may have additional attributes populated for product type code and description) 


-—Location Assured 


09 — Exchange Based 
10 — Pack and Collect 


058 
254 
255 
256 
259 
261 
262 
263 
426 
428 


--Hold for Pickup 

-—Lift Gate Service for Delivery 
-—Lift Gate Service for Pickup 
-—Drop Off At Facility 
--Directto Retail 

-—Deliver to Addressee only 
-—Deliver to Retail COD 
-—Retail to Retail Shipment 
-—Direct Delivery Only 


-—Package Release Code 
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Reference Number Codes 


Package 

13 --UPS Waybill Number 
16 --Reference Number 

17 --Reference Number 

19 — Reference Number 

28 -—Purchase Order No. 

33 -—Model Number 

34 -—Part Number 

35 -—Serial Number 

50 --Department Number 

51 --Store Number 

54 --FDA Product Code 

55 -—Acct. Rec. Customer Acct. 
56 -—Appropriation Number 
57 --Bill of Lading Number 
58 --Employer” ID Number 
59 -—Invoice Number 

60 -—Manifest Key Number 
61 -—Dealer Order Number 
62 -—Production Code 

63 -—Purchase Req. Number 
64 --Salesperson Number 
65 --Social Security Number 
67 --Transaction Ref. No. 
RZ --RMA 

9V --COD Number 


Freight 


BL --Bill of Lading 
PO -—-PO Number 


Mail Innovations 
91 --USPS PIC 


93 --USPS (30 char, truncated barcode number) 


94 — Mail Manifest System Number (MMS) 
95 -—Mail Manifest ID (MMI) 


96 -—Mail Innovations (reference number, customer package id (PID)) 
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Request Option Matrix 


When requesting tracking information, applications may use the RequestOption field to indicate the specific types of 
information they wish to receive. 


Request Option | Proofof Delivery |COD Info | Receiver Address |All Activity 
0 Xx 


1 X 
2 X X X 
3 X X X 
4 X X X 
5 X X X 
6 X X X X 
7 X X X X 
activity X 
none X 
blank or empty X 


Signature Tracking only 


Request Option | Proofof Delivery |COD Info | Receiver Address All Activity Sig Image 
8 Xx X 


X 
9 X X X 
10 X X X 
11 X X X X 
12 X X X X 
13 X X X X 
14 X X X X X 
15 X X X X 
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Request Option Codes 


Mail Innovations willonly return: none, 0, or 1. 
none, "“"“ 0=Last Activity (default) 

1= All activity 

2= POD, Receiver Address and Last Activity 
3= POD, Receiver Address, All Activity 
4=POD,COD, Last Activity 

5=POD, COD, All Activity 

6=POD, COD, Receiver Address, Last Activity 
7=POD,COD, Receiver Address, All Activity 


Signature Tracking only 


The Signature Tracking interface recognizes a Signature track by RequestOption. 


June 23, 2021 


If the user submits a request with a request option of""’-—"5"then Signature Tracking must validate the user’s rights to 
use signature track. 
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8=POD, Signature Image, Last Activity 

9=POD, Signature Image, All Activity 

10=POD, Signature Image, Receiver Address, Last Activity 
11=POD, Signature Image, Receiver Address, All Activity 
12=POD, Signature Image, COD, Last Activity 

13=POD, Signature Image, COD, All Activity 

14=POD, Signature Image, COD, Receiver Address, Last Activity 
15=POD, Signature Image, COD, Receiver Address, All Activity 
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Service Codes 


United States 


Shipments originating in United States 


UPS 3 Day Select 

UPS Ground 

UPS Next Day Air 

UPS Next Day Air Early 
UPS Saver 

UPS 2n¢Day Air 

UPS 2n¢Day Air A.M. 
numUPS Standard 

UPS Worldwide Expedited 
UPS Worldwide Express 


UPS Worldwide Express Plus 


United States Domestic Shipments 


UPS 2n¢Day Air 

UPS 2n¢Day Air A.M. 
UPS 3 Day Select 

UPS Ground 

UPS Next Day Air 

UPS Next Day Air Early 
UPS Next Day Air Saver 
UPS Saver 
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012 
003 


002 
059 
012 
003 
001 
104 
013 
065 
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Canada 

Description [category Cod 
UPS 3 Day Select Shipments originating in Canada 012 
UPS Express Shipments originating in Canada going to the United 001 

States 

UPS Express Shipments originatingin Canada 001 
UPS Express Early Shipments originating in Canada 014 
UPS Saver Shipments originating in Canada 065 
UPS Standard Shipments originating in Canada 011 
UPS WorldwideExpedited | Shipments originatingin Canadato US and Mexico 008 
UPS WorldwideExpedited | Shipments originatingin Canadato Canada 002 


European Union 


Shipments originating in the European Union 


UPS Expedited 008 
UPS Express 007 
UPS Saver 065 
UPS Standard 011 
UPS Worldwide Express Plus 054 


Mexico 


Shipments originating in Mexico 


UPS Expedited 008 
UPS Express 007 
UPS Express Plus 054 
UPS Saver 065 
UPS Standard 011 
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Poland 
UPS Expedited 008 
UPS Express 007 
UPS Saver 065 
UPS Standard 011 
UPS Today Dedicated Courrier 083 
UPS Today Express 085 
UPS Today Express Saver 086 
UPS Today Standard 082 
UPS Worldwide Express Plus 054 


Puerto Rico 


Shipments originating in Puerto Rico 


UPS 2n¢Day Air 002 
UPS Ground 003 
UPS Next Day Air 001 
UPS Next Day Air Early 014 
UPS Saver 065 
UPS Worldwide Expedited 008 
UPS Worldwide Express 007 
UPS Worldwide Express Plus 054 


Undefined Countries/Territories 


Use for all countries other than United States, Canada, European Union, Mexico, Poland, and Puerto Rico 


UPS Express 007 
UPS Saver 065 
UPS Standard 011 
UPS Worldwide Expedited 008 
UPS Worldwide Express Plus 054 
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All Countries/Territories 


Shipments originating in all countries 


UPS Worldwide Express Freight 096 
UPS Worldwide Express FreightMidday 071 
UPS® Worldwide Economy DDU 017 
UPS® Worldwide Economy DDP 072 


Mail Innovations 


UPS Mail Innovations 701 


Freight Service Codes 


Freight Shipments originating in all countries /territories 


Expedited Air Freight 346 
Expedited Ground Freight 347 
Standard LTL 349 
Trade Direct Air TDA 
Trade Direct Cross Border TDCB 
Trade Direct Ocean TDO 
UPS Crossborder Connect 335 
UPS Freight LTL 308 
UPS Freight LTL Guaranteed 309 
UPS Freight LTL Guaranteed A.M. 334 
UPS FreightLTL Urgent 310 
UPS Ocean 336 
UPS Ocean Break Bulk 344 
UPS Ocean Forwarding 342 
UPS Ocean Forwarding 343 
UPS Ocean tanker 345 
UPS Preferred 337 
UPS Preferred 338 
UPS Preferred 341 
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UPS Worldwide Expedited™ GroundFreight 649 
UPS Worldwide Expedited ™ Truckload 650 
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State / Province Codes 


United States 


Alaska AK 
Alabama AL 
Arkansas AR 
Arizona AZ 
California CA 
Colorado CO 
Connecticut CT 


District of Columbia | DC 


Delaware DE 
Florida FL 
Georgia GA 
Hawaii HI 

lowa IA 

Idaho ID 

Illinois IL 

Indiana IN 

Kansas KS 
Kentucky KY 
Louisiana LA 
Massachusetts MA 
Maryland MD 
Maine ME 
Michigan MI 

Minnesota MN 
Missouri MO 
Mississippi MS 
Montana MT 
North Carolina NC 
North Dakota ND 
Nebraska NE 


New Hampshire NH 
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New Jersey NJ 
New Mexico NM 
Nevada NV 
New York NY 
Ohio OH 
Oklahoma OK 
Oregon OR 
Pennsylvania PA 
Rhode Island Rl 


South Carolina SC 


South Dakota SD 
Tennessee TN 
Texas TX 
Utah UT 
Virginia VA 
Vermont VT 
Washington WA 
Wisconsin WI 
West Virginia WV 
Wyoming WY 
Canada 
Alberta AB 
British Columbia BC 
Manitoba MB 
New Brunswick NB 


Newfoundland and Labrador | NL 


Nova Scotia NS 
Northwest Territories NT 
Nunavut NU 
Ontario ON 
Prince Edward Island PE 
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Quebec Qc 
Saskatchewan SK 
Yukon Territory YT 
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Subversion details 


UPS uses sub version strategy to give back new elements in the SOAP Webservice response when there is no 
functionality changein the request. In order to ensure that we do not break the SOAP Webservice client's application, 
we give back the new elements only when the subversion is specified in the request. 


SubVersion New Elements/Error Descriptions Error Code 
Values 


0114 /TrackRequest/Request/SubVersion 

1407 

1507 

0114 and /TrackResponse/Shipment/DeliveryDateUnavailable 

greater /TrackResponse/Shipment/DeliveryDateUn available/Type 
/TrackResponse/Shipment/DeliveryDateUnavailable/Description 

0114 and /TrackResponse/Shipment/Package/Redirect 

greater /TrackResponse/Shipment/Package/Redirect/CompanyName 


/TrackResponse/Shipment/Packag e/Redirect/Location|ID 
/TrackResponse/Shipment/Package/Redirect/PickupDate 


0114 and /TrackResponse/Shipment/Package/Activity/NextSch eduleActivity 

greater /TrackResponse/Shipment/Package/Activity/NextSch eduleActivity/Date 
/TrackResponse/Shipment/Package/Activity/NextSch eduleActivity/Time 

1407 and /TrackResponse/Shipment/Package/Dimen sionalW eightScan Indicator 

greater 

1507 and /TrackResponse/Shipment/Package/Activity/Delivery DateFromManifestIndicator 

greater 


1907and greater /TrackResponse/Shipment/Package/Activity/GMT Date 
/TrackResponse/Shipment/Package/Activity/GMT Time 
/TrackResponse/Shipment/Packag e/Activity/GMT Offset 


1909 and /TrackResponse/Shipment/Package/SRSizeCode 

greater 

2009 and /TrackResponse/Shipment/Package/UPSPremierAccessorial 
greater 


/TrackResponse/Shipment/Package/UPSPremierAccessorial/UPSPremierCode 
/TrackResponse/Shipment/Package/UPSPremierAccessorial/UPSPremierDescription 


/TrackResponse/Shipment/Package/Activity/SensorEventlndicator 
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Locale codes 


The following table lists all supported locale codes (country/territory and language combination). Refer to the 
Country/Territory Codes Appendix section for Country/Territory details. 


Localeis accepted in below format Example: - Locale - en_US means ‘LanguageCode_CountryCode’ 


Locale Code 


bg_BG 
cs_CZ 
da_DK 
de_ AT 
de_CH 
de DE 
el_CY 

el_GR 
en_AE 
en_AG 
en_Al 

en_AL 
en_AR 
en_AT 
en_AU 
en_AW 
en_AZ 
en_BA 
en_BB 
en_BD 
en_BE 
en_BG 
en_BH 
en_BL 
en_BM 
en_BO 
en_BQ 
en_BR 
en_BS 
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